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“188 。 JSP 网 络 开发 技术 及 整合 应 用 


// 获 得 一 个 数据 库 连接 

Connection conn = DriverManager.getConnection(url,user,passw); 

// 获 得 一 个 Statement 对 象 用 于 发 送 SQL 语句 

Statement stmt = conn. createStatement(); 

为 了 执行 Statement 对 象 的 方法 ， 需 要 把 发 送 到 数据 库 的 SQL 语句 作为 参数 提供 给 
Statement 对 象 的 方法 ， 使 用 Statement 对 象 执行 语句 。Statement 接口 提供 了 如 下 所 示 的 3 
个 发 送 SQL 语句 的 方法 。 

口 ResultSet executeQuery(String sql): 用 于 产生 单个 结果 集 的 语句 ， 如 select 语句 。 

口 ResultSet executeUpdate(String sql): 用 于 执行 insert、update 或 delete 语句 等 ， 返 回 

是 一 个 整数 ， 表 示 受 影响 的 行 数 〈 即 更 新 计数 ) 。 

口 ResultSet execute(…): 运行 语句 ， 返 回 是 否 有 结果 集 。 

对 于 返回 一 个 结果 集 的 executeQuery() 方 法 , 在 检索 完 ResultSet 对 象 的 所 有 行 时 该 语句 
完成 。 对 于 方法 executeUpdate()， 当 它 执行 时 语句 即 完 成 。 

4. 操作 结果 集 一 一 ResultSet 接口 

ResultSet 接口 用 于 装载 查询 结果 , 并 可 以 通过 它 的 不 同方 法 提取 出 查询 结果 。ResultSet 
包含 符合 SQL 语句 条 件 的 所 有 行 ， 且 它 通 过 一 套 GET 方法 (这 些 GET 方法 可 以 访问 当前 
行 中 的 不 同 列 ) 提供 了 对 这 些 行 中 数据 的 访问 。 

ResultSet.next() 方 法 将 记录 指针 移动 到 ResultSet 记录 集 的 下 一 行 ， 使 之 成 为 当前 行 。 
全 注意 ; 结果 集 ResultSet 是 一 张 二 维 表 ， 其 中 有 查询 所 返回 的 列 标题 及 相应 的 值 ， 并 且 结 

果 集 的 游标 初始 时 是 指向 第 一 行 的 上 一 行 ， 其 实 没有 指向 真实 数据 ， 所 以 在 得 到 
数据 时 ， 要 首先 调用 语句 resultnext()。 


11.4 通过 JDBC 访问 数据 库 


在 体会 了 使 用 JSP 和 JDBC 开发 的 一 个 简单 数据 库 应 用 并 了 解 了 JDBC 的 相关 知识 后 ， 
就 可 以 转 入 更 加 正式 一 点 的 学 习 过 程 了 ， 下 面 将 会 介绍 如 何 结合 JDBC 驱动 程序 的 类 型 等 
相关 知识 开发 实际 的 数据 库 应 用 程序 。 

JDBC 驱动 程序 可 分 为 以 下 4 个 种 类 : JDBC-ODBC 桥 加 ODBC 了 驱动 程序 、 本 地 
API 部 分 用 Java 来 编写 的 驱动 程序 、JDBC 网 络 纯 Java 驱动 程序 和 本 地 协议 纯 Java 驱 
动 程序 。 

第 1、2 类 驱动 程序 在 直接 的 纯 Java 驱动 程序 还 没有 上 市 前 将 会 作为 过 渡 方 案 来 使 用 ; 
第 3、4 类 驱动 程序 将 成 为 从 JDBC 访问 数据 库 的 首选 方法 。 在 本 书 中 介绍 使 用 JDBC-ODBC 
桥 加 ODBC 驱动 程序 和 本 地 协议 纯 Java 驱动 程序 ， 这 也 是 比较 常用 的 两 种 驱动 程序 ， 读 者 
如 果 对 另外 两 种 驱动 程序 感 兴趣 可 以 参考 相关 的 技术 资料 。 


11.4.1 使 用 JDBC-ODBC 桥 连 接 数据 库 


JavaSoft (JDBC 的 官方 网 站 ) 桥 产品 利用 ODBC 驱动 程序 提供 JDBC 访问 。 使 用 这 种 
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方式 时 ， 必 须 将 ODBC 二 进 制 代码 (许多 情况 下 还 
包括 数据 库 客户 机 代码 ) 加 载 到 使 用 该 驱动 程序 的 和 
每 个 客户 机 上 。 因 此 ， 这 种 类 型 的 驱动 程序 最 适合 于 
企业 网 , 或 者 是 用 Java 编写 的 三 层 结构 的 应 用 程序 服 


务 器 代码 。 如 图 11.9 所 示 是 这 种 连接 方法 的 结构 。 二 
下 面 介绍 使 用 JDBC-ODBC 桥 加 ODBC 驱动 程 

序 实现 数据 库 连接 ， 由 于 这 种 方式 暂时 还 不 支持 Gules: | .< Fe 

MySQL 数据 库 (也 可 以 安装 组 件 实现 支持 MySQL， ea eh 

不 过 不 是 一 种 很 好 的 方式 ， 这 里 不 作 介 绍 ) ， 所 以 | 

在 本 例 中 不 使 用 上 面 建立 的 MySQL 数据 库 i 和 

jdbctestdb， 而 是 使 用 了 Access 新 建 一 个 数据 库 。 下 DBMS DBMS 

面 是 使 用 这 种 驱动 程序 的 基本 步骤 。 ee 


图 11.9 JDBC-ODBC 桥 加 ODBC 驱动 


(1) 建立 数据 库 和 数据 表 ， 数 据 库 是 
1) 建立 数据 库 和 数据 表 ， 数 据 库 的 名 字 是 程序 连接 结构 


jdbctestdb， 数 据 表 的 名 字 是 animalInfo， 有 具体 建立 数 
据 库 和 数据 表 的 方法 请 参考 其 他 书籍 。 
(2) 建立 ODBC 数据 源 ， 建 立 数据 源 〈 指 建立 ODBC 数据 源 ) ， 数 据 源 名 称 为 Petmfo， 
具体 的 建立 方法 请 参考 其 他 书籍 。 
全 注意 ; 建立 ODBC 数据 源 时 ， 应 该 选择 建立 为 系统 DSN。 
(3) 建立 数据 库 连 接 ， 使 用 JDBC 建立 数据 库 的 连接 ， 首 先 要 加 载 数 据 库 驱 动 程序 ， 
实现 此 功能 的 语句 如 下 : 
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver"); 
然后 ， 使 用 特定 的 URL 与 数据 库 建立 连接 : 
Drivermanger.getConnection(String url,String user, String password) 
DriverManager 类 用 于 人 处理 驱动 程序 的 载 入 并 且 对 新 的 数据 库 连接 提供 支持 。 
(4) 发 送 SQL 语句 ，JDBC 提供 了 Statement 类 来 发 送 SQL 语句 ， 因 此 要 想 执 行 SQL 
语句 ， 必 须要 先 建立 Statement 对 象 ，Statement 对 象 由 Connection 类 的 createStatement 方法 
创建 ， 有 具体 程序 实现 如 下 : 


stmt=con.createStatement(); 


在 建立 Statement 对 象 后 ， 就 可 以 用 建立 Statement 对 象 发 送 SQL 语句 给 数据 库 系 统 执 
行 ， 执 行 返回 的 结果 通常 存放 在 一 个 ResultSet 类 的 对 象 中 。ResultSet 可 以 看 作 是 一 个 表 ， 
这 个 表 包 含 由 SQL 返回 的 列 名 和 相应 的 值 , ResultSet 对 象 中 维持 了 一 个 指向 当前 行 的 指针 ， 
通过 一 系列 的 getXXX 方法 ， 可 以 检索 当前 行 的 各 个 字段 ， 从 而 显示 出 来 。 下 面 是 把 上 面 的 
例子 修改 后 的 完整 代码 。 

<!- jdbcodbcjsp --> 

<%@ page contentType= "text/html; charset=gb2312" language="java" import="java.sql.” errorPage 

=""%> 

<html> 
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<head> 


<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title>JDBC-ODBC 测试 程序 </title> 

<style type="text/css"> 

<!-- 

.style1{ 

font-size: 36px; 

font-family: Geneva, Arial, Helvetica, sans-serif' 

-> 


</style> 


</head> 


<body> 


<p> 


<% 


%> 


</p> 


Connection conn=null; 
try 


{ 
// 加 载 数据 库 驱动 程序 
Class.forName("sun.jdbc.odbc.JdbcOodbcDriver ).newlnstance(); 


// 与 数据 库 建立 连接 ， 得 到 Connection 的 对 象 

conn = DriverManager.getConnection("jdbc:odbc:PetInfo",” "," "); 
}catch(Exception e) 
ud 


} 


out.printin(e); 


<p align="center" class="style1"> 登 记 宠 物 信息 </p> 
<table width="700" border="1" align="center bordercolor="#000000" bgcolor="#CCCCCC"> 
<tr> 


<th scope="col">Animal ID</th> 

<th scope="col">Animal 类 型 </th> 

<th scope="col">Animal 名 字 </th> 

<th scope="col">Animal 主人 </th> 

<th scope="col">Animal 生日 </th> 

<th scope="col">Animal 描述 信息 </th> 


</tr> 


<% 


try 
{ 
// 得 到 Statement 的 对 象 
Statement stmt = conn.createStatement(); 
// 发 送 SQL 语句 ， 并 得 到 执行 结果 


ResultSet rs = stmt.executeQuery("select * from animallnfo ); 
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// 处 理 返 回 结果 
while(rs.next()){ 


%> 
<tr bgcolor="#DDDDDD"> 
<td bgcolor="#DDDDDD"><div align="center"><%=rs.getString("ID")%></div></td> 
<td bgcolor="#DDDDDD"><div align="center"><%=rs.getString("Ani_Type")%></div></td> 
<td bgcolor="#DDDDDD"><div align="center"><%=rs.getString("Ani_Name")%></div></td> 
<td bgcolor="#DDDDDD"><div align="center"><%=rs.getString("Ani Owner")%></div></td> 
<td bgcolor="#DDDDDD"><div align="center"><%=rs.getString("Ani_Birthday")%></div></td> 
<td bgcolor="#DDDDDD"><div align="center"><%=rs.getString("Ani_Description")%></div></td> 
</tr> 
<% 


} 

// 释 放 资 源 
rs.close(); 
stmt.close(); 
conn.close(); 


}catch(Exception e) 


out.printin(e); 
} 


%> 
</table> 
</body> 
</html> 


外 注意 : (1) 这 份 代码 与 第 一 节 中 代码 的 一 个 区 别 是 获得 数据 库 连 接 的 方式 改变 了 ， 还 有 


在 输出 字符 囊 时 不 需要 进行 编码 方式 的 转换 ， 因 为 中 文 版 Access 内 部 的 默认 编码 
方式 是 支持 中 文 的 。 

(2 ) 如果 提示 “javax.servlet.ServletException: [Microsoft][ODBC 驱动 程序 管理 器 ] 
未 发 现 数据 源 名 称 并 且 未 指定 默认 驱动 程序 ”错误 ， 请 检查 ODBC 数据 源 是 否 被 
建立 为 系统 DSN。 


这 个 程序 运行 后 ， 效 果 如 图 11.2 所 示 。 


11.4.2 ”使 用 本 地 协议 纯 Java 驱动 程序 连接 数据 库 


本 地 协议 纯 Java 驱动 程序 将 JDBC 调用 直接 转换 为 DBMS 所 使 用 的 网 络 协议 。 这 将 允 
许 从 客户 机 上 直接 调用 DBMS 服务 器 ， 是 Intranet 访问 的 一 个 很 实用 的 解决 方法 。 由 于 许 
多 这 样 的 协议 都 是 专用 的 ， 因 此 数据 库 提供 者 自身 将 是 主要 来 源 ， 有 几 家 数据 库 厂商 已 开 
始 做 这 些 工 作 了 。 如 图 11.10 所 示 是 使 用 这 种 驱动 程序 连接 数据 库 的 结构 。 


使 
程序 连 


本 地 协议 纯 Java 驱动 程序 连接 数据 库 的 步骤 和 使 用 JDBC-ODBC 桥 加 ODBC 驱动 


接 数据 库 的 过 程 基本 是 一 致 的 ， 差 别 在 于 使 用 本 地 协议 纯 Java 驱动 程序 连接 数据 库 


不 需要 建立 ODBC 数据 源 ， 也 不 能 直接 连接 数据 库 文 件 〈 在 使 用 JDBC-ODBC 桥 时 是 可 以 
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实现 的 ) ， 事 实 上 ， 在 11.1 节 中 介绍 的 例子 就 是 使 用 这 种 驱动 程序 实现 连接 数据 库 的 ， 下 
面 介 绍 对 这 个 例子 进行 扩展 ， 使 得 它 能 对 数据 库 进行 查询 、 添 加 新 的 记录 ， 并 把 访问 数据 
库 的 代码 从 JSP 文件 中 分 离 出 来 ， 提 高 JSP 文件 的 简洁 性 。 


Java 应 用 程序 


了 + 


JDBC API 


驱动 程序 管理 器 


Oracle Access 
DBMS DBMS 
a Ns 


图 11.10 本 地 协议 纯 Java 驱动 程序 


1. 编写 实现 数据 库 操作 的 JavaBeans 
在 本 例 中 使 用 的 JavaBeans 要 求 具 有 数据 库 连 接 、 数 据 库 查询 和 更 新 数据 库 数据 的 功 


能 ， 下 面 是 PetDBUtiljava 的 源 代码 : 


package cn.ac.ict; 
import java.sql.*; 
public class PetDBUtil{ 
Connection conn=null; 
String url = "jdbc:mysql://localhost:3306/jdbctestdb"; 
String user = "root"; 
String passw = "ict"; 
public PetDBUtil() { 
super(); 


} 


// 加 载 数据 库 驱 动 程序 ， 并 连接 数据 库 
public boolean connect(){ 
try{ 
// 加 载 数据 库 驱 动 程序 
Class.forName("com.mysql.jdbc.Driver').newlnstance(); 
/与 数据 库 建立 连接 ， 得 到 Connection 的 对 象 
conn = DriverManager.getConnection(url,user,passw); 


}catch(Exception ex){ 
// 出 错 处 理 
System.out.printin("Drivers Load Error!"); 
return false; 

} 


return true; 
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// 执 行 数据 库 查 询 ， 传 入 的 参数 是 使 用 的 查询 语句 
public ResultSet query(String sql){ 

ResultSet rs = null; 

Statement stmt; 


// 检 查 是 否 已 经 连接 到 数据 库 
if(conn==null){ 
connect(); 
! 
try{ 
// 得 到 Statement 的 对 象 
stmt = conn.createStatement(); 
// 发 送 SQL 语句 ， 并 得 到 执行 结果 
rs = stmt.executeQuery(sql); 
return rs; 
} catch (SQLException e){ 
// 出 错 处 理 
e.printStackTrace(); 
return null; 


} 


// 执 行 数据 更 新 ， 传 入 的 参数 是 更 新 时 使 用 的 SQL 语句 
public boolean update(String sql){ 
Statement stmt; 
int mcount; 
if(conn==null){ 
connect(); 
} 
try{ 
// 得 到 Statement 的 对 象 
stmt = conn.createStatement(); 
mcount = stmt.executeUpdate(sql); 


if(mcount<1){ 
return false; 
} 

}catch (SQLException e) { 
/ 出 错 处 理 
e.printStackTrace(); 

} 

return true; 


1 


// 回 收 资源 ， 只 有 数据 库 连 接 conn 是 全 局 变量 ， 只 需要 关闭 conn 
public boolean close(){ 
try{ 
// 释 放 资 源 
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conn.close(); 

}catch (SQLException e){ 
// 出 错 处 理 
e.printStackTrace(); 

} 


conn=null; 
return true; 


} 
在 这 个 类 中 有 4 个 方法 ， 分 别 实现 数据 库 连 接 、 数 据 库 查询 、 更 新 数据 库 数据 和 关闭 


数据 库 连 接 的 功能 ， 读 者 可 以 对 照 注 释 了 解 各 个 语句 的 作用 。 


2. 编写 调用 JavaBeans 的 JSP 文件 
在 本 实例 中 使 用 了 6 个 JSP 文件 ， 分 别 完成 不 同 的 功能 ， 其 中 petjsp 用 于 接受 查询 输 
完整 代码 如 下 : 


<%@ page contentType="text/html; charset=gb2312” language="java"” import="java.sql.™ 
errorPage="" %> 
<!IDOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title> 具 有 查询 和 更 新 功能 的 JDBC 应 用 </title> 
<style type="text/css"> 
< 
.Style1 {font-size: 24px} 
-> 
</style> 
</head> 
<body bgcolor="#FFFFFF"> 
<div align="center"> 
<p> 
<span class="style1"> 具有 查询 和 更 新 功能 的 JDBC 应 用 </span> </p> 
<table> 
<tr> 
<td><%@ include file="link.jsp"%></td> 
</tr> 
</table> 
<form action="petoperation.jsp" method="post" name="form1" target="_self’> 
<div align="left"> 
<p align="center"> 
<label> 输 入 要 查询 的 条 件 
<select name="type"> 
<option value="ID" selected>ID</option> 
<option value="Ani_ Type"> 宠 物 类 型 </option> 
<option value="Ani_Name"> 宠 物 昵 名 </option> 
<option value="Ani_Owner"> 宠 物 主人 </option> 
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<option value="Ani_Birthday"> 宠 物 生 日 </option> 
</select> 
<select name="comp"> 
<option value="&gt;=" selected>&gt;=</option> 
<option value="&lt;=">&lt=</option> 
<option value="=">=</option> 
</select> 
<input name="typevalue" type="text" value="2003-01-02" size="20" maxlength="20"> 
</label> 
</p> 
<p align="center"> 
<label> 
<input type="submit" name="Submit" value=" 提 交 "> &nbsp;&nbsp;&nbsp;&nbsp; 
<input name="reset" type="reset" id="reset" value=" 重 置 "> 
</label> 
</p> 
</div> 
</form> 
<p> 
</p> 
</div> 
</body> 
</html> 


在 petjsp 的 一 个 表单 中 声明 表单 被 提交 到 petoperation.jsp 页 面 ， 这 是 用 于 显示 查询 结 
果 的 一 个 页 面 ， 其 完整 代码 如 下 : 


<%@ page contentType="text/html; charset=gb2312” language="java” import="java.sql.” 
errorPage="" %> 
<IDOCTYPE HTML PUBLIC "-//W3CWDTD HTML 4.01 Transitional//EN" "http://www.w3.org 
/TR/html4/loose.dtd"> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title> 具 有 查询 和 更 新 功能 的 JDBC 应 用 </title> 
<jsp:useBean id="petUtil" scope="request" class="cn.ac.ict.PetDBUtil" /> 
<style type="text/css"> 
al 
.style1 {font-size: 24px} 
.Style2 {font-size: 18px} 
-> 
</style> 
</head> 
<% 
petUtil.connect(); 
String sel_type; 
String sel_comp; 
String sel_type_value; 
String sql; 
// 获 取 请 求 参 数 
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sel type = request.getParameter("type"); 

sel _ comp = request.getParameter("comp"); 

sel type value =request.getParameter("typevalue"); 

Sql = "select * from animalinfo where "+sel type+sel comp+"' "+Sel type value+"'"; 


%> 
<body> 
<div align="center"><span class="style1"> 查 询 结果 </span></div> 
<table> 
<tr> 
<td><%@ include file="link.jsp"%></td> 
</tr> 
</table> 
<table width="700" border="1" align="center" bordercolor="#000000" bgcolor="#CCCCCC"> 
<tr> 
<th scope="col">Animal ID</th> 
<th scope="col">Animal 类 型 </th> 
<th scope="col">Animal 名 字 </th> 
<th scope="col">Animal 主人 </th> 
<th scope="col">Animal 生日 </th> 
<th scope="col">Animal 描述 信息 </th> 
<th scope="col"> 修 改 </th> 
</tr> 
<p> 


<% 
ResultSet rs = petUtil.query(sql); 
if((rs!=null)&&(!Irs.isLast())){ 
while(rs.next()\{ 
%> 

<tr bgcolor="#DDDDDD"> 

<td bgcolor="#DDDDDD"><div align="center"><%=rs.getString("ID")%></div></td> 

<td bgcolor="#DDDDDD"><div align="center"><%=new String(rs.getString("Ani_Type"). getBytes 
("ISO8859-1"),"gb2312")%></div></td> 

<td bgcolor="#DDDDDD"><div align="center><%=new String(rs.getString("Ani_Name"). getBytes 
("ISO8859-1"),"gb2312")%></div></td> 

<td bgcolor="#DDDDDD"><div align="center"><%=new String(rs.getString("Ani_Owner"). getBytes 
("ISO8859-1"),"gb2312")%></div></td> 

<td bgcolor=#DDDDDD"><div align="center><%=new String(rs.getString("Ani_Birthday"). getBytes 
("ISO8859-1"),"gb2312")%></div></td> 

<td bgcolor="#DDDDDD"><div align="center"><%=new String(rs.getString("Ani_Description"). 
getBytes("ISO8859-1"),"gb2312")%></div></td> 

<td bgcolor=#DDDDDD"><div align="center"><a href="modify.jsp?id=<%=rs.getString("ID") 
%>"> 修 改 </a></div></td> 

</tr> 
<%} 
}%> 


</body> 
</html> 


在 显示 查询 结果 的 petoperation.jsp 页 面 中 每 条 记录 都 会 有 一 个 超 链接 用 于 修改 记录 ， 
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于 接受 修改 数据 的 页 面 是 modifgy.jsp， 其 完整 代码 如 下 : 


<%@ page contentType="text/html; charset=gb2312” language="java" import="java.sql.™ 
errorPage="" %> 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR 
/html4/loose.dtd"> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title> 修 改 宠物 记录 </title> 
<style type="text/css"> 
<|-- 


.style1 {font-size: 18px} 


<!--- ”声明 一 个 使 用 的 JavaBeans 一 -> 
<jsp:useBean id="petUtil" scope="request" class="cn.ac.ict.PetDBUtiM /> 
<% 
String id =request.getParameter("id"); 
String sql = null; 
ResultSet rs = null; 
if(id!=nullX{ 
Sql ="select * from animalinfo where ID=" "+id+" '"; 
// 查 询 数据 库 获 取 结 果 
rs = petUtil.query(sql); 
rs.next(); 
%> 
<body> 
<table width="700" border="0" align="center > 
<tr> 
<td><div align="center" class="style1"> 修 改 宠物 记录 
</div></td> 
</tr> 
<tr> 
<td><%@ include file="link.jsp"%></td> 
</tr> 


<tr> 
<td height="135"> 
<form target="_self" action="modify_confirm.jsp?id=<%=id%>" method="post"> 
<table width="500" border="0" align="center"> 
<tr bgcolor=#CCCCCC"> 
<td><div align="center> 宠 物 ID</div></td> 
<td> 
<div align="left"> 
<label><%=rs.getString("ID")%></label> 
</div></td> 
</tr> 
<tr bgcolor=#CCCCCC"> 
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<td> <div align="center"> 宠 物 类 型 </div></td> 
<td> 
<div align="left"> 
<input name="Ani Type" type="text” id="Ani Type" value="<%=new String(rs. 
getString("Ani Type").getBytes("ISO8859-1"),"gb2312")%>"> 
</div></td> 
</tr> 
<tr bgcolor=#CCCCCC"> 
<td> <div align="center'> 宠 物 昵 名 </div></td> 
<td> 
<div align="left"> 
<input name="Ani_Name" type="text"” id="Ani Name" value="<%=new String(rs. 
getString("Ani_Name").getBytes("ISO8859-1"),"gb2312")%>"> 
</div></td> 
</tr> 
<tr bgcolor="#CCCCCC"> 
<td> <div align="center'> 宠 物 主 人 </div></td> 
<td> 
<div align="left"> 
<input name="Ani Owner" type="text" id="Ani Owner" value="<%=new String(rs. 
getString("Ani_Owner").getBytes("ISO8859-1"),"gb2312")%>"> 
</div></td> 
</tr> 
<tr bgcolor="#CCCCCC"> 
<td> <div align="centerm> 宠 物 生 日 </div></td> 
<td> 
<div align="left"> 
<input name="Ani_Birthday" type="text" id="Ani_Birthday" value="<%=new String 
(rs.getString("Ani_Birthday").getBytes("ISO8859-1"),"gb2312")%>"> 
</div></td> 
</tr> 
<tr bgcolor=#CCCCCC"> 
<td> <div align="center"> 宠 物 描述 信息 </div></td> 
<td> 
<div align="left"> 
<input name="Ani_Description" type="text” id="Ani_Description" value="<%=new 
String(rs.getString("Ani_Description").getBytes("|SO8859-1"),"gb2312")%>"> 
</div></td> 
</tr> 
<tr bgcolor="#CCCCCC"> 
<td> <div align="center"> 
<input type="submit" name="Submit" value=" 提 交 "> 
</div></td> 
<td><div align="center"> 
<input name="reset" type="reset" id="reset" value=" 重 置 "> 
</div></td> 
</tr> 
</table> 
</form> 
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</td> 
</tr> 
</table> 
<%}%> 
</body> 
</html> 


这 个 文件 中 表单 的 提交 页 面 是 modify_confirm.jsp， 在 这 个 页 面 中 完成 将 信息 写 到 数据 
库 中 的 任务 ， 其 完整 代码 如 下 : 


<%@ page contentType="text/html; charset=gb2312" language="java"” import="java.sql.* 
errorPage="" %> 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR 
/html4/loose.dtd"> 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title> 更 新 宠物 记录 </title> 

</head> 


<body> 
<jsp:useBean id="petUtil" scope="request" class="cn.ac.ict.PetDBUtil" /> 
<% 
String id = request.getParameter("id"); 
String newid = request.getParameter("newid"); 
String type = request.getParameter("Ani_Type"); 
String name = request.getParameter("Ani_Name"); 
String owner = request.getParameter("Ani_Owner"); 
String birthday = request.getParameter("Ani_Birthday"); 
String description = request.getParameter("Ani_Description"); 
String sql=null; 
petUtil.connect(); 
if(id!=null){ 
/构造 SQL 语句 
sql = "update animalinfo set Ani_Type=' "+type+" "Ani_Name=' "+name+" "Ani_Owner="' "+owner+" ', 
Ani_Birthday =' "+birthday+" ',Ani_Description=' "+description+" ' where ID=' "+id+" '"; 


}else if(newid!=null{ 

// 构 造 SQL 语句 

sql = "insert into animalinfo values(' "+newid+" "' "+type+" ',' "+name+" '' "+owner+" ',' "+birthday+" ', 
'"+ description+" ")"; 

} 

// 执 行 SQL 语句 ， 并 判断 是 否 执行 成 功 
ifpetUtil.update(sql)){f 
response.sendRedirect("pet.jsp"); 

} 

out.print(sql); 

%> 

</body> 

</html> 
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在 这 个 页 面 中 可 以 完成 插入 数据 和 修改 数据 的 功能 ， 另 一 个 用 于 接受 新 加 宠物 信息 的 
页 面 addjsp 的 表单 的 提交 目的 也 是 这 个 页 面 ， 它 根据 不 同 的 ID 区 分 是 修改 数据 还 是 新 添 
加 数据 。 接 受 新 加 宠物 信息 的 页 面 addjsp 的 完整 代码 如 下 : 


<%@ page contentType="text/html; charset=gb2312” language="java"” import="java.sql.*™ 
errorPage="" %> 
<!DOCTYPE HTML PUBLIC "-/W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR 
/html4/loose.dtd"> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title> 添 加 宠物 记录 </title> 
<style type="text/css"> 
<l-- 
.style1 {font-size: 18px} 
-> 
</style> 
</head> 


<body> 
<table width="700" border="0" align="center"> 
<tr> 
<td><div align="center" class="style1"> 添 加 宠物 记录 
</div></td> 
</tr> 
<tr> 
<td><%@ include file="link.jsp"%></td> 
</tr> 
<tr> 
<td height="135"> 
<form target=" self" action="modify confirm.jsp" method="post"> 
<table width="500" border="0" align="center"> 
<tr bgcolor="#CCCCCC"> 
<td><div align="center"> 宠 物 1D</div></td> 
<td> 
<div align="left"> 
<input name="newid" type="text" id="newid"> 
</div></td> 
</tr> 
<tr bgcolor="#CCCCCC"> 
<td> <div align="center"> 宠 物 类 型 </div></td> 
<td> 
<div align="left"> 
<input name="Ani Type" type="text" id="Ani Type"> 
</div></td> 
</tr> 
<tr bgcolor="#CCCCCC"> 
<td> <div align="center"> 宠 物 昵 名 </div></td> 
<td> 
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<div align="left"> 
<input name="Ani Name" type="text" id="Ani Name"> 
</div></td> 
</tr> 
<tr bgcolor='#CCCCCC"> 
<td> <div align="center'> 宠 物 主 人 </div></td> 
<td> 
<div align="left"> 
<input name="Ani_Owner" type="text" id="Ani_Owner"> 
</div></td> 
</tr> 
<tr bgcolor='#CCCCCC"> 
<td> <div align="center'> 宠 物 生 日 </div></td> 
<td> 
<div align="left"> 
<input name="Ani_Birthday" type="text" id="Ani_Birthday"> 
</div></td> 
</tr> 
<tr bgcolor="#CCCCCC"> 
<td> <div align="center"> 宠 物 描述 信息 </div></td> 
<td> 
<div align="left"> 
<input name="Ani_Description" type="text" id="Ani_Description"> 
</div></td> 
</tr> 
<tr bgcolor="#CCCCCC"> 
<td> <div align="center"> 
<input type="submit" name="Submit" value=" 提 交 "> 
</div></td> 
<td><div align="center"> 
<input name="reset" type="reset" id="reset" value=" 重 置 "> 
</div></td> 
</tr> 
</table> 
</form> 
</td> 
</tr> 
</table> 
</body> 
</html> 


另外 一 个 用 于 包含 的 文件 中 包含 了 一 些 连 接 信息 ， 很 简单 ， 就 不 在 此 列举 了 。 
3. 发 布 运行 Web 应 用 
所 有 需要 的 文件 都 编写 完成 后 ， 这 个 Web 应 用 的 结构 如 图 11.11 所 示 。 把 JDBCFirst 
文件 夹 复制 到 <TOMCAT_HOME>/webapps 目录 下 ， 启 动 Tomcat， 然 后 在 浏览 器 地 址 栏 中 
输入 如 下 地 址 : http://localhost:8080/JDBCFirst/pet.jsp， 可 以 看 到 页 面 显 示 如 图 11.12 所 示 。 
单 击 【 提 交 】 按 钮 ， 显 示 查 询 结 果 ， 页 面 显 示 如 图 11.13 所 示 。 
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如 果 要 修改 Kitty 的 信息 ， 可 以 单 击 Kitty 后 面 的 修改 超 链接 ， 把 描述 信息 修改 为 “ 活 
泼 可 爱 的 小 猫咪 ”。 显 示 页 面 如 图 11.14 所 示 。 
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图 11.11 JDBC 应 用 结构 图 11.12 查询 界面 
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提交 后 ， 就 可 以 通过 再 次 查询 查看 修改 的 结果 了 。 还 有 添加 新 记录 的 页 面 ， 在 所 有 的 
显示 页 面 上 都 提供 了 链接 ， 单 击 【添加 新 的 宠物 记录 】 链 接 后 ， 填 入 宠物 的 信息 ， 显 示 如 
图 11.15 所 示 。 
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图 11.15 ”添加 新 的 宠物 记录 
提交 后 ， 可 以 再 查询 查看 修改 结果 ， 显 示 如 图 11.16 所 示 。 
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图 11.16 数据 更 新 结果 


11.4.3 ”使 用 PreparedStatement 接口 发 送 SQL 语句 一 一 数据 录入 例子 

在 11.3 节 中 讲 到 JDBC API 的 一 个 比较 重要 的 接口 是 PreparedStatement, 在 上 面 的 例子 

中 已 经 可 以 完整 地 实现 数据 库 的 功能 了 ， 那 么 PreparedStatement 接口 是 用 来 干什么 的 呢 ? 
PreparedStatement 接口 继承 于 Statement 接口 ,是 经 过 扩展 的 一 个 用 户 发 送 SQL 语句 的 接口 ， 
它 与 Statement 在 三 个 方面 有 所 不 同 。 
口 PreparedStatement 实例 包含 已 编译 的 SQL 语句 ， 就 是 使 语句 “准备 好 ”的 意思 。 包 
含 于 PreparedStatement 对 象 中 的 SQL 语句 可 含有 一 个 或 多 个 参数 ,参数 的 值 在 SQL 
语句 创建 时 未 被 指定 。 相 反 地 ， 该 语句 为 每 个 参数 保留 一 个 问号 〈“?”) 作为 占 
位 符 。 每 个 问号 的 实际 值 必须 在 该 语句 执行 之 前 , 通过 适当 的 setXXX 方法 来 提供 。 
口 由 于 PreparedStatement 对 象 已 预 编译 过 ， 所 以 其 执行 速度 要 比 Statement 对 象 快 。 
因此 ， 多 次 执行 的 SQL 语句 创建 为 PreparedStatement 对 象 ， 可 以 提高 效率 。 
口 作为 Statement 的 子 类 ，PreparedStatement 继承 了 Statement 的 所 有 功能 。 另 外 它 还 添 
加 了 一 整套 方法 ， 用 于 设置 发 送 给 数据 库 以 取代 参数 占 位 符 的 值 。 同 时 ， 三 种 方法 
execute、executeQuery 和 executeUpdate 已 被 更 改 以 使 之 不 再 需要 参数 。 这 些 方法 的 
Statement 形式 〈 接 受 SQL 语句 参数 的 形式 ) 不 应 该 用 于 PreparedStatement 对 象 。 
下 面 介绍 一 个 简单 的 例子 来 演示 PreparedStatement 接口 的 使 用 。 在 这 个 例子 中 借用 了 
前 面 一 直 使 用 的 数据 库 ， 用 于 向 数据 库 中 添加 大 量 的 宠物 信息 。 

1. 创建 PreparedStatement 对 象 

创建 PreparedStatement 对 象 与 创建 Statement 是 不 同 的 ， 以 下 的 代码 段 (其 中 conn 是 
Connection 对 象 ) 创建 包含 带 两 个 参数 占 位 符 的 SQL 语句 的 PreparedStatement 对 象 : 


pstmt 对 象 包含 语句 " insert into animalinfo values(?,?,?,?,?,?)"， 它 已 发 送 给 DBMS， 并 为 
执行 作 好 了 准备 ， 但 现在 还 不 能 得 到 任何 执行 结果 ， 因 为 例子 中 在 SQL 语句 中 设置 了 多 个 
参数 ， 下 面 讲述 如 何 传递 这 些 参数 。 

2. 传递 参数 

在 执行 PreparedStatement 对 象 之 前 ， 必 须 设 置 每 个 “?” 参 数 的 值 。 这 可 通过 调用 一 系 
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列 setXXX 方法 来 完成 ， 其 中 XXX 是 与 该 参数 相应 的 类 型 。 例 如 ， 如 果 参 数 具 有 Java 类 型 
Long， 则 使 用 的 方法 就 是 setLong。setXXX 方法 的 第 一 个 参数 是 要 设置 参数 的 序数 位 置 ， 
第 二 个 参数 是 设置 给 该 参数 的 值 。 例 如 ， 以 下 代码 将 第 4 个 参数 设 为 "jacky"， 第 5 个 参数 
设 为 2005-10-21。 


pstmt.setString(4,"jacky"); 
pstmt.setDate(5,new Date(105,9,21)); 


全 注意 : java.sql.Date 日 期 的 构造 函数 第 一 个 参数 是 减 去 1900 后 的 年 数 (2005-1900=105 ) ， 
第 二 个 参数 是 月 数 (第 一 个 月 是 0， 以 后 依次 类 推 ) ， 第 三 个 参数 是 日 期 数 。 

一 旦 设置 了 给 定语 句 的 参数 值 ， 就 可 用 它 多 次 执行 该 语句 ， 直 到 调用 clearParameters 
方法 清除 它 为 止 。 在 连接 的 默认 模式 下 (启用 自动 提交 ) ， 当 语句 完成 时 将 自动 提交 或 回 
深 该 语句 (执行 失败 时 〉。 

如 果 基 本 数据 库 和 驱动 程序 在 语句 提交 之 后 仍 保持 这 些 语 句 的 打开 状态 ， 则 同一 个 
PreparedStatement 可 执行 多 次 。 如 果 没 有 这 一 功能 , 那么 试图 使 用 PreparedStatement 对 象 代 
奉 Statement 对 象 来 提高 性 能 是 没有 意义 的 。 

下 面 是 使 用 PreparedStatement 对 象 的 JSP 文件 的 完整 代码 : 


<%@ page contentType="text/html; charset=gb2312” language="java” import="java.sql.” 
errorPage="" %> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title>PreparedStatement 接口 使 用 测试 </title> 
<style type="text/css"> 
< 
.style2 {font-size: 16px} 
-> 
</style> 
</head> 


<body> 

<p align="left"> 

<% 
Connection conn=null; 
String url = "jdbc:mysql://localhost:3306/jdbctestdb"; 
String user = "root"; 
String passw = "ict"; 
intid_name = 1010; 
int i=0; 
long startime =0; 
long endtime =0; 
String id_prefix = "Smthgk"; 
// 加 载 数据 库 驱 动 程序 
Class.forName("com.mysql.jdbc.Driver").newlInstance(); 
// 获 取 数 据 库 连接 
conn = DriverManager.getConnection(url,user,passw); 

// 获 取 一 个 PreparedStatement 对 象 
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/下面 设置 各 个 参数 的 值 
pstmt.setString(2,new String(" 金 丝 鸟 ".getBytes("gb2312"),"ISO8859-1")); 
pstmt.setString(4,"jacky"); 
pstmt.setDate(5,new Date(105,9,21)); 
pstmt.setString(6,new String(" 大 量 养殖 的 鸟 ! ".getBytes("gb2312"),"|ISO8859-1")); 
startime = new java.util.Date().getTime(); 
while(i<100){ 
id_name+=1; 
pstmt.setString(1,id_prefix+id_name); 
pstmt.setString(3,new String((" 佳 佳 "+id_name).getBytes("gb2312"),"|SO8859-1")); 
pstmt.execute(); 
i++; 
} 
endtime = new java.util.Date().getTime(); 
pstmt.clearParameters(); 


pstmt.close(); 
conn.close(); 
%> 
<span class="style2"> 向 数据 库 中 写 入 100 条 记录 总 共用 了 <%=endtime-startime%> 毫 秒 ! </span> 
</body> 
</html> 
各 序 运行 后 的 效果 如 图 11.17 所 示 。 Te ee RD We 
[ED 站 站 Vr 《| “ 
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setXXX 方法 中 的 XXX 是 Java 类 型 。 它 是 一 2 ee 


种 隐 含 的 JDBC 类 型 (一般 SQL 类 型 ) ， 因 为 驱 La Mn 

动 程序 将 把 Java 类 型 映射 为 相应 的 JDBC 类 型 ， 图 11.17 PreparedStatement 接口 使 用 测试 
并 将 该 JDBC 类 型 发 送 给 数据 库 。 例 如 ， 在 上 面 

的 例子 中 ， 把 第 5 个 参数 设置 为 “2005-10-21”， 例 子 中 是 使 用 setDate 方式 设置 的 ， 但 事 
实 上 也 是 完全 可 以 使 用 setString 方法 设置 的 。 也 就 是 说 上 面 的 pstmt.setDate(5,new 
Date(105,9,21)); 是 完全 可 以 使 用 pstmt.setString(5,"2005-10-21"); 来 代替 的 。 驱 动 程序 将 
"2005-10-21" 转 换 为 DBC Date， 然 后 发 送 给 数据 库 ， 而 例子 中 使 用 的 new Date(105,9,21) 是 
Java Date 类 型 的 标准 映射 。 程 序 员 的 责任 是 确保 将 每 个 参数 的 Java 类 型 映射 为 与 数据 库 所 
需 的 JDBC 数据 类 型 兼容 的 JDBC 类 型 。 


11.4.4 使 用 JDBC 的 数据 库 事务 操作 一 一 银行 转账 


在 实际 应 用 中 往往 要 求 几 名 SQL 语句 同时 执行 或 同时 不 执行 ， 那 么 只 使 用 上 面 提 到 的 
技术 是 不 够 的 ， 而 数据 库 事务 就 是 用 来 解决 这 个 难题 的 一 个 技术 ， 下 面 介绍 数据 库 事务 以 
及 如 何 通 过 JDBC 使 用 数据 库 事务 。 

1. JDBC 的 数据 库 事务 概述 

在 JDBC 的 数据 库 操 作 中 ， 一 项 事务 是 由 一 条 或 是 多 条 表达 式 所 组 成 的 一 个 不 可 分 割 
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的 工作 单元 。 通 过 提交 commit() 或 者 回 深 rollback0 来 结束 事务 的 操作 。 关 于 事务 操作 的 方 
法 都 位 于 接口 Java.sql.Connection 中 。 

2. JDBC 的 数据 库 事务 特点 

口 在 JDBC 中 ,事务 操作 默认 是 自动 提交 。 也 就 是 说 ,一 条 对 数据 库 的 更 新 表达 式 代 
表 一 项 事务 操作 ， 操 作成 功 后 ， 系 统 将 自动 调用 commit() 来 提交 ， 和 否则 将 调用 
rollback() 来 回 滚 。 

口 在 JDBC 中 , 可 以 通过 调用 setAutoCommit(false) 来 禁止 自动 提交 。 之 后 就 可 以 把 多 
个 数据 库 操作 的 表达 式 作 为 一 个 事务 ， 在 操作 完成 后 调用 commit0 来 进行 整体 提 
交 ， 倘若 其 中 一 个 表达 式 操 作 失 败 ， 都 不 会 执行 到 commit()， 并 且 将 产生 响应 的 异 
常 。 此 时 就 可 以 在 异常 捕获 时 调用 rollback0 进 行 回 滚 。 这 样 做 可 以 保持 多 次 更 新 操 
作 后 相关 数据 的 一 致 性 。 

口 JDBC API 支持 事务 对 数据 库 的 加 锁 ， 并 且 提 供 了 5 种 操作 支持 ， 两 种 加 锁 密度 ， 
其 中 5 种 支持 是 指 如 下 几 种 操作 支持 。 

static int TRANSACTION_NONE = 0; 

禁止 事务 操作 和 加 锁 。 

static int TRANSACTION_READ_UNCOMMITTED = 1; 

允许 脏 数据 读 写 (dirty reads)、 重 复读 写 (repeatable reads) 和 影 象 读 写 (phntom reads) 。 

static int TRANSACTION_READ_COMMITTED = 2; 

禁止 脏 数据 读 写 (dirty reads), 允许 重复 读 写 (repeatable reads ) 和 影 象 读 写 (phntom reads ) 。 

static int TRANSACTION_REPEATABLE_READ = 4; 

禁止 脏 数据 读 写 (dirty reads ) 和 重复 读 写 (repeatable reads), 允许 影 象 读 写 (phntom reads ) 。 

static int TRANSACTION_SERIALIZABLE = 8; 

禁止 脏 数据 读 写 (dirty reads)、 重 复读 写 (repeatable reads ) 和 允许 影 象 读 写 (phntom reads ) 。 

两 种 密度 是 指 上 面 的 操作 可 以 分 为 两 类 ， 其 中 最 后 一 项 为 表 加 锁 ， 其 余 3、4 项 为 行 加 

锁 。 对 于 上 面 提 到 的 一 些 术语 解释 如 下 : 

口 脏 数据 读 写 〈dirty reads) : 当 一 个 事务 修改 了 某 一 数据 行 的 值 而 未 提交 时 ， 另 一 
事务 读 取 了 此 行 值 。 倘 若 前 一 事务 发 生 了 回 滚 , 则 后 一 事务 将 得 到 一 个 无 效 的 值 ( 脏 
数据 ) 。 

口 重复 读 写 (repeatable reads) : 当 一 个 事务 在 读 取 某 一 数据 行 时 ， 另 一 事务 同时 在 
修改 此 数据 行 。 则 前 一 事务 在 重复 读 取 此 行 时 将 得 到 一 个 不 一 致 的 值 。 

口 影 象 读 写 (phntom reads) : 当 一 个 事务 在 某 一 表 中 进行 数据 查询 时 ， 另 一 事务 恰 
好 插入 了 满足 查询 条 件 的 数据 行 。 则 前 一 事务 在 重复 读 取 满 足 条 件 的 值 时 , 将 得 到 
一 个 额外 的 “ 影 象 ” 值 。 

JDBC 根据 数据 库 提 供 的 默认 值 来 设置 事务 支持 及 其 加 锁 ， 当 然 ， 也 可 以 手工 设置 ， 使 

用 Connection 接口 的 如 下 方法 设置 。 
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setTransactionlsolation (TRANSACTION_READ UNCOMMITTED) 
可 以 使 用 Connection 接口 的 如 下 方法 查看 数据 库 的 当前 设置 。 
getTransactionlsolation() 
在 进行 手动 设置 时 ， 数 据 库 及 其 驱动 程序 必须 支持 相应 的 事务 操作 才 行 。 

3. 银行 系统 转账 例子 

数据 库 事务 的 一 个 典型 应 用 就 是 银行 系统 的 转账 操作 ， 当 钱 从 一 个 账户 取出 后 ， 就 一 

定 要 存 入 对 方 账 号 ， 和 否则 第 一 个 账户 中 的 钱 就 应 该 被 放 回 原 处 。 
首先 需要 建立 一 个 数据 表 bank_account 保存 账户 的 信息 ， 其 字段 的 描述 如 表 11.3 所 示 。 


表 11.3 数据 表 bank_account 结 构 


是 否 为 主键 
ACC ID 是 
username char(20) 否 
mone: float 奋 


向 其 中 添加 两 条 数据 记录 ， 如 表 11.4 所 示 。 
表 11.4 数据 表 bank_account 中 的 数据 


100223564587896 
100223564854566 


现在 要 做 的 是 harry 要 给 mary 转账 1000 块 钱 ， 实 现 的 程序 如 下 : 


<%@ page contentType="text/html; charset=gb2312” language="java" import="java.sql.” 
errorPage="" %> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title>PreparedStatement 接口 使 用 测试 </title> 
<style type="text/css"> 
本 二 
.style2 {font-size: 16px} 
.style3 {font-size: 18px} 
-> 
</style> 
</head> 


<body> 
<p align="left"> 
<% 
Connection conn=null; 
String url = "jdbc:mysql://localhost:3306/jdbctestdb"; 
String user = "root"; 
String passw = "ict"; 
String sql = null; 


= 208 “= 
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// 加 载 数据 库 驱 动 程序 
Class.forName("com.mysql.jdbc.Driver").newlInstance!(); 


// 获 取 数 据 库 连 接 


conn = DriverManager.getConnection(url,user,passw); 
// 禁 止 自动 提交 ， 设 置 回 滚 点 
conn.setAutoCommit(false); 
Statement stmt = conn.createStatement(); 
ResultSet rs = stmt.executeQuery("select * from bank_account"); 


%> 


<span class="style3"> 转 账 之 前 ， 账 户 的 信息 如 下 : </span> 
<table width="500" border="0" align="center bordercolor="#CCCCCC"> 


<tr> 
<th scope="col"> 账 号 </th> 
<th scope="col"> 姓 名 </th> 
<th scope="col"> 剩 余 金 额 </th> 
</tr> 
<%while(rs.next()){%> 
<tr> 


<td><%=rs.getString("ACC_ID")%></td> 
<td><%=rs.getString("username")%></td> 


<td><%=rs.getFloat("money")%></td> 
</tr> 


<%}%> 
</table> 
<p align="left"> <% 
try{ 
/数据 库 更 新 操作 


sql = "update bank_account set money=money-1000 where ACC 1ID='100223564587896' "; 
stmtexecuteUpdate(sql); 


sql = "update bank_account set money=money+1000 where ACC_1ID='100223564854566' "; 
stmtexecuteUpdate(sql); 


// 事 务 提交 
conn.commit(); 
}catch(Exception ex){ 
ex.printStackTrace(); 


/操作 不 成 功 则 回 滚 
conn.rollback(); 
}catch(Exception e){ 


e.printStackTrace(); 
by 


} 
// 下 面 执行 查询 操作 ， 查 看 事务 的 提交 结果 
rs = stmt.executeQuery("select * from bank_account ); 
%> 
<span class="style3"> 转 账 之 后 ， 账 户 的 信息 如 下 : </span> 


<table width="500" border="0" align="center" bordercolor="#CCCCCC"> 
<tr> 


<th scope="col"> 账 号 </th> 
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<th scope="col"> 姓 名 </th> 
<th scope="col"> 剩 余 金 额 </th> 
</tr> 
<%while(rs.next()){%> 
<tr> 
<td><%=rs.getString("ACC_ID")%></td> 
<td><%=rs.getString("username")%></td> 
<td><%=rs.getFloat("money")%></td> 
</tr> 
<%}%> 
</table> 
<%rs.close(); 
stmtclose(); 
conn.close();%> 
</body> 
</html> 


将 这 个 文件 复制 到 已 经 发 布 的 Web 应 用 中 (如 
JDBCFirst) , 然后 访问 这 个 应 用 , 页 面 显 示 如 图 11.18 
所 示 。 

这 是 转账 成 功 时 的 效果 , 如 果 因 为 完整 性 约束 的 
限制 或 者 其 他 原因 造成 了 两 次 更 新 操作 中 的 任何 一 
次 失败 都 会 使 整个 事务 回 深 ， 恢复 到 原来 的 状态 , 保 
障 了 储户 的 利益 。 


图 11.18 银行 系统 转账 例子 


11.5 JSP 与 数据 库 连 接 池 


在 Java 语言 中 ，JDBC (Java Data Base Connection ) 是 应 用 程序 与 数据 库 沟 通 的 桥梁 ， 
一 般 来 说 ，Java 应 用 程序 访问 数据 库 的 过 程 ( 如 图 11.19 所 示 ) 如 下 : 

口 装载 数据 库 驱 动 程序 。 

口 通过 JDBC 建立 数据 库 连 接 。 

口 访问 数据 库 ， 执 行 SQL 语句 。 

口 断 开 数据 库 连 接 。 

但 使 用 这 种 模式 开发 ， 存 在 很 多 问题 。 首 先 ， 系 统 要 为 每 一 次 Web 请 求 〈 例 如 下 载 一 
幅 图 片 ) 建立 一 次 数据 库 连 接 ， 对 于 一 次 或 几 次 操作 来 讲 ， 系 统 的 开销 还 是 比较 小 的 ， 但 
对 于 Web 程序 来 讲 ， 即 使 在 某 一 较 短 的 时 间 段 内 ， 其 操作 请 求 数 也 远 远 不 是 一 两 次 ， 而 是 
数 十 上 百 次 ， 在 这 种 情况 下 ， 系 统 开销 是 相当 大 的 。 事 实 上 ， 在 一 个 基于 数据 库 的 Web 系 
统 中 ， 建 立 数据 库 连 接 的 操作 将 是 系统 中 代价 最 大 的 操作 之 一 。 很 多 时 候 ， 一 个 网 站 速度 
瓶颈 就 在 于 此 。 

其 次 ， 使 用 传统 的 模式 ， 系 统 必须 去 管理 每 一 个 连接 ， 确 保 它 们 能 被 正确 关闭 ， 如 果 
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出 现 程序 异常 而 导致 某 些 连 接 未 能 关闭 ， 将 导致 数据 库 系 统 中 的 内 存 泄 露 ， 最 终 将 不 得 不 
重新 启动 数据 库 。 


图 11.19 Java 应 用 程序 访问 数据 库 的 过 程 


再 次 是 安全 性 问题 ， 由 于 程序 代码 中 包含 用 户 名 和 密码 ， 其 他 人 如 果 能 得 到 字 节 码 ， 
可 以 通过 反 编 译 工具 获得 用 户 名 和 密码 。 还 有 就 是 代码 的 可 移植 性 问题 。 如 果 希 望 连接 的 
数据 库 名 称 或 用 户 名 有 所 更 改 ， 程 序 员 需 要 修改 源 程序 ， 然 后 把 修改 过 的 程序 发 送 给 用 户 。 
也 就 是 说 ， 软 件 无 法 脱离 数据 库 独 立 存 在 。 这 样 不 仅 会 大 大 提高 软件 的 成 本 ， 也 不 利于 软 
件 本 身 的 发 展 。 

基于 传统 横 式 存在 的 诸多 问题 ， 数 据 库 连 接 池 〈Connection Pool) 技术 被 提出 来 解决 上 
述 问 题 。 数 据 库 连接 池 模 型 应 该 包括 一 个 连接 池 类 (DBConnection Pool) 和 一 个 连接 池 管 
理 类 (DBConnection Pool Manager) 。 连 接 池 类 是 对 某 一 数据 库 所 有 连接 的 “缓冲 池 ”， 主 
要 实现 以 下 功能 : 

口 从 连接 池 获 取 或 创建 可 用 连接 。 

口 使 用 完毕 之 后 ， 把 连接 返还 给 连接 池 。 

口 在 系统 关闭 前 ， 断 开 所 有 连接 并 释放 连接 占用 的 系统 资源 。 

口 能 够 处 理 无 效 连接 (原来 登记 为 可 用 的 连接 ， 由 于 某 种 原因 不 再 可 用 ， 如 超时 、 通 

信 问 题 ), 并 能 够 限制 连接 池 中 的 连接 总 数 不 低 于 某 个 预定 值 和 不 超过 某 个 预定 值 。 

连接 池 管 理 类 是 连接 池 类 的 包装 类 (Wrapper) ， 符 合 单 例 模式 ， 即 系统 中 只 能 有 一 个 
连接 池 管 理 类 的 实例 。 其 主要 用 于 对 多 个 连接 池 对 象 的 管理 ， 具 有 以 下 功能 : 

口 装载 并 注册 特定 数据 库 的 JDBC 驱动 程序 。 

口 根据 属性 文件 给 定 的 信息 ， 创 建 连 接 池 对 象 。 

口 为 方便 管理 多 个 连接 池 对 象 ， 为 每 一 个 连接 池 对 象 取 一 个 名 字 ， 实 现 连接 池 名 字 与 

其 实例 之 间 的 映射 。 

口 跟踪 客户 使 用 连接 情况 ， 以 便 需 要 时 关闭 连接 释放 资源 。 

连接 池 管 理 类 的 引入 主要 是 为 了 方便 对 多 个 连接 池 的 使 用 和 管理 ， 如 系统 需要 连接 不 同 
的 数据 库 , 或 连接 相同 的 数据 库 但 由 于 安全 性 问题 , 需要 不 同 的 用 户 使 用 不 同 的 名 称 和 密码 。 

当 程序 中 需要 建立 数据 库 连 接 时 ， 只 需 从 内 存 中 取 一 个 来 用 而 不 用 新 建 。 同 样 ， 使 用 
完毕 后 ， 只 需 放 回 内 存 即 可 。 而 连接 的 建立 、 断 开 都 由 连接 池 自 身 来 管理 。 同 时 ， 还 可 以 
通过 设置 连接 池 的 参数 来 控制 连接 池 中 的 连接 数 、 每 个 连接 的 最 大 使 用 次 数 等 。 通 过 使 用 
连接 池 ， 将 大 大 提高 程序 效率 ， 同 时 ， 可 以 通过 其 自身 的 管理 机 制 来 监视 数据 库 连 接 的 数 
量 、 使 用 情况 等 。 
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11.6 JSP 与 数据 源 (DataSource ) 


11.6.1 数据 源 DataSource) 简介 


数据 源 是 在 JDBC 2.0 中 引入 的 一 个 概念 。 在 JDBC 2.0 扩展 包 中 定义 了 javax.sql.Data 
Source 接口 来 描述 这 个 概念 。 如 果 用 户 希 望 建立 一 个 数据 库 连 接 ， 通 过 查询 在 JNDI (Java 
Naming and Directory Interface，Java 名 称 和 目录 服务 接口 ) 服务 中 的 数据 源 ， 可 以 从 数据 源 
中 获取 相应 的 数据 库 连 接 。 这 样 用户 就 只 需 提 供 一 个 逻辑 名 称 (Logic Name) ， 而 不 是 数 
据 库 登录 的 具体 细节 。 


11.6.2 ”配置 使 用 数据 源 


- 般 都 是 通过 JNDI 来 使 用 数据 源 的 ， 在 本 节 中 以 在 Tomcat 中 配置 使 用 数据 源 来 讲述 
如 何在 JSP 技术 中 使 用 数据 源 。 
1. 准备 MySQL 数据 库 
在 本 例 中 使 用 “ 某 实验 室 网 站 ”的 数据 库 名 space_web， 读 者 可 以 参考 相关 MySQL 的 
书籍 建立 数据 库 ， 由 于 本 例 只 是 验证 使 用 数据 源 连 接 数 据 库 ， 可 以 不 用 建立 数据 表 。 
2. 配置 数据 源 
下 面 介绍 配置 数据 源 的 方法 。 数 据 源 可 以 通过 修改 server.xml 文件 的 Context 元 素 配 置 
数据 源 或 者 在 Context 片断 中 配置 ， 它 们 的 配置 方法 是 一 样 的， 当然 数据 源 的 配置 也 可 以 使 
用 Tomcat 提供 的 Admin 系统 配置 管理 应 用 程序 实现 。 下 面 介 绍 使 用 修改 server.xml 文件 
Context 元 素 配 置 数据 源 。 
(1) 打开 TOMCAT_ HOME\conf 目 录 。 
(2) 找到 并 打开 server.xml 文件 。 
(3) 在 Web 应 用 的 虚拟 目录 中 添加 信息 ， 如 果 所 要 配置 的 虚拟 目录 不 存在 ， 则 在 
</Host> 之 前 添加 如 下 信息 : 
<?xml version='1.0' encoding='utf-8'?> 
<!--- ”定义 一 个 Context 的 属性 信息 ， 如 Web 应 用 的 根 目录 和 访问 路 径 等 ---> 
<Context crossContext="true”debug="5”docBase="E:/PublishBookjlab”path="lab”reloadable 
="true" swallowOutput="true" workDir="work\Catalina\localhost\lab"> 
二 三 
<Logger> 是 创建 这 个 应 用 的 log 文件 信息 ,其 中 prefix 和 suffix 决定 了 日 志文 件 的 名 字 和 扩展 名 ， 这 
样 设置 后 会 在 TOMCAT_HOME/ logs/ 目 录 下 生成 localhost log.2005-05-04.txt 文件 
-> 
<Logger className="org.apache.catalina.logger.FileLogger" 
prefix="localhost_lab_log." suffix=".txt" 


timestamp="true"/> 
4 
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<Resource> 被 定义 为 该 应 用 可 以 使 用 的 资源 ， 最 主要 的 就 是 把 一 个 DataSource 与 这 个 应 用 相关 联 
了 ， 并 设 定 相关 的 参数 -> 
<Resource name="jdbc/lab" type="javax.sql.DataSource"/> 
<ResourceParams name="jdbc/lab"> 
<!-- 等 待 一 个 数据 库 连 接 有 效 的 最 长 时 间 一 > 
<parameter> 
<name>maxWait</name> 
<value>5000</value> 
</parameter> 
<!-- 在 连接 池 中 活动 数据 库 连接 的 最 大 数目 ， 
应 该 配置 MySQL 数据 库 ， 使 得 它 可 以 满足 所 有 应 用 的 需要 ， 设 置 为 0 表示 没有 任何 限制 --> 
<parameter> 
<name>maxActive</name> 
<value>4</value> 
</parameter> 
<!-- MySQL 数据 库 系统 的 用 户 名 和 密码 --> 
<parameter> 
<name>username</name> 
<value>root</value> 
</parameter> <parameter> 
<name>password</name> 
<value>ict</value> 
</parameter> 
<!-- JDBC 连接 使 用 的 URL 地址 ”--> 
<parameter> 
<name>url</name> 
<value>jdbc:mysql://localhost:3306/shopdb?autoReconnect=true</value> 
</parameter> 
<!-- 官方 MySQL 的 JDBC 驱动 程序 的 类 名 --> 
<parameter> 
<name>driverClassName</name> 
<value>com.mysql.jdbc.Driver<NValue> 


</parameter> 
<!-- 在 连接 池 中 不 活动 数据 库 连接 的 最 大 数目 ， 设 置 为 -1 表示 没有 任何 限制 --> 
<parameter> 


<name>maxldle</name> 
<value>2</value> 
</parameter> 


</ResourceParams> 
</Context> 


全 注意 : 实际 使 用 时 ， 要 把 所 有 的 中 文 注释 全 部 去 掉 ， 否 则 会 无 法 正确 加 载 Web 应 用 。 

3. 安装 驱动 程序 

将 MySQL 的 驱动 程序 文件 mysql-connector-java-3.1.8-binjar〔 读 者 也 可 以 使 用 MySQL 
其 他 版 本 的 JDBC 驱动 程序 ) 复制 到 TOMCAT_HOME\common\lib 目录 下 ， 如 果 只 把 驱动 程 
序 放 在 Web 应 用 的 \WEB-INF\lib 目录 下 ，Tomcat 中 的 数据 源 是 无 法 正确 加 载 驱动 程序 的 。 

4. 编写 测试 文件 

在 本 例 中 编写 一 个 测试 文件 ， 它 使 用 了 上 面 配置 的 数据 源 。 下 面 是 测试 文件 
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(Cdatasourceconn.jsp) 的 代码 : 


<%@ page contentType="text/html; charset=gb2312"”language="java”import="java.sql.*java. 
lang.” errorPage=""%> 
<% 
String lang = "CH"; 
/下 面 这 些 代码 是 用 于 网 站 版 本 转换 的 ， 不 是 数据 源 的 必要 成 分 ， 但 为 了 让 它 能 够 完全 蔡 换 原来 的 
conn.jsp 文件 ， 这 里 也 列 出 来 
String lang_session = (String)session.getAttribute("lang"); 
String lang _ request = (String)request.getParameter("language"); 
iflang_request==nulllllang_requestequals(”")){f 
if((lang_session!=nul)&&(llang_session.equals(”")))f 
lang = lang_session; 
session.setAttribute("lang",lang); 
Jelse{ 


session.setAttribute("lang","CH"); 


} 
jelse{ 
lang = lang_request; 
session.setAttribute("lang",lang); 
} 
/下 面 使 用 数据 源 获取 连接 


Connection conn=null; 


try{ 
// 获 得 初始 上 下 文 对 象 
InitialContext ctx = new InitialContext(); 
// 查 找 并 获得 一 个 数据 源 对 象 
DataSource ds = (DataSource) ctx.lookup("java:comp/env/idbc/lab"); 
// 从 数据 库 连 接 池 中 得 到 一 个 数据 库 连 接 
conn = ds.getConnection(); 
}catch(Exception ex){ 
out.printin(" 数 据 库 驱 动 加 载 出 现 错误 ! "+ex); 


%> 


读者 可 以 自己 在 数据 库 space-web 中 建立 数据 表 并 添加 部 分 数据 ， 进 行 各 种 数据 库 操 
更 好 地 理解 数据 源 的 使 用 。 


合 


Ll 汉 结 


在 本 章 中 介绍 了 关系 数据 库 和 SQL 语言 的 基础 知识 、 使 用 JDBC 操作 数据 库 的 一 些 知 
识 ， 了 解 了 常用 数据 库 的 连接 方法 ， 掌 握 了 JDBC 的 几 个 关键 类 和 常用 接口 。 在 本 章 中 的 
一 个 重点 是 学 会 使 用 JDBC 连接 数据 库 ， 并 进行 各 种 数据 库 的 操作 。 

本 章 中 介绍 的 很 多 知识 对 于 初学 者 是 很 有 用 的 ， 而 且 对 于 一 些小 型 的 Web 应 用 都 是 很 
适合 采用 的 技术 。 
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Java 提供 的 Java Mail API， 使 得 发 送 邮 件 变 得 非常 简单 。 而 且 随 着 企业 级 应 用 的 扩展 ， 
很 多 企业 的 信息 管理 系统 中 需要 使 用 独立 的 邮件 系统 发 送 邮 件 ， 这 样 就 使 得 Java Mail Web 
应 用 得 到 了 广泛 的 应 用 。 本 章 介绍 如 何 建 立 Java Mail Web 应 用 。 


12.1 Java Mail 的 简单 实例 


12.1.1 准备 邮件 服务 器 


要 运行 本 章 中 介绍 的 例子 ， 都 需要 有 一 个 邮件 服务 器 ， 读 者 使 用 的 是 Magic winmail 试 
用 版 ， 并 新 建立 一 个 用 户 名 为 jmailapp， 密 码 也 为 jmailapp， 所 属 的 域名 是 domain.com， 具 
体 其 安装 方法 可 以 参考 其 相关 文档 。 


12.1.2 ”编写 程序 


在 本 小 节 编 写 一 个 简单 的 程序 ， 这 个 程序 可 以 用 来 发 送 邮件 ， 可 以 指定 发 送 的 接收 者 。 
源 代码 〈JMailSend.java) 如 下 : 


package cn.ac.ict; 

import java.util.Properties; 

import javax.mail.Message; 

import javax.mail.MessagingException; 
import javax.mail.Session; 

import javax.mail. Transport; 

import javax.mail.URLName; 

import javax.mail.internet.AddressException; 
import javax.mail.internet.InternetAddress; 
import javax.mail.internet.MimeMessage; 


public class JMailSend { 
public static void main (String args[]X{ 

String smtpHost = args[0]; 
String from =args[1]; 
String to = args[2]; 
String userName = args[3]; 
String password = args[4]; 
SmtpAuth auth = null; 


第 12 章 JSP 与 Java Mail Web 应 “215 。 


/ 获取 系统 属性 

Properties props = System.getProperties(); 

auth = new SmtpAuth(); 
auth.setUserinfo(userName,password); 

/ 设置 邮件 服务 器 相关 信息 

props.put("mail.smtp.host", smtpHost); 
props.put("mail.smtp.auth", "true"); 
props.put("mail.smtp.port", "25"); 
props.put("mail.transport.protocol","smtp"); 
props.put("mail.store.protocol","imap"); 
props.put("mail.stmp.class","com.sun.mail.smtp.SMTPTrasport"); 
props.put("mail.imap.class","com.sun.mail.imap.IMAPStore"); 


/ 得 到 一 个 会 i 
Session session = 
Session.getDefaultlnstance(props, auth); 
session.setPasswordAuthentication(new 
URLName(smtpHost),auth.getPasswordAuthentication()); 


/ 定义 一 个 消息 

MimeMessage message = new MimeMessage(session); 

try{ 
message.setFrom(new InternetAddress(from)); 
message.addRecipient(Message.RecipientType.TO, new InternetAddress(to)); 
message.setSubject("JMail Test Application"); 
message.setText("You JMail Application is successful!"); 


// 发 送 消息 
Transport.send(message); 
System.out.print("Send Successfully!"); 

} catch (AddressException e) { 
e.printStackTrace(); 

} catch (MessagingException e){ 
e.printStackTrace(); 

} 
} 


如 果 邮 件 服务 器 需要 进行 验证 ， 就 需要 使 用 一 个 Authenticator 的 对 象 ， 提 供认 证 信息 。 
在 本 实例 中 是 通过 一 个 Authenticator 的 子 类 SmtpAuth 的 对 象 auth 来 实现 的 。 如 下 : 
auth = new SmtpAuth(); 


auth.setUserinfo(userName,password); 


// 得 到 一 个 会 话 
Session session = Session.getDefaultlnstance(props, auth); 
session.setPasswordAuthentication(new URLName(smtpHost),auth.getPasswordAuthentication()); 


在 得 到 一 个 会 话 后 ， 在 这 个 会 话 的 基础 上 建立 一 个 消息 : 
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// 定义 一 个 消息 
MimeMessage message = new MimeMessage(session); 


在 对 这 个 消息 的 一 些 内 容 进行 设置 后 ， 就 可 以 发 送出 去 了 。 


12.1.3 ”运行 程序 并 查看 效果 


上 面 的 程序 是 一 个 普通 的 Java 应 用 程序 ， 可 以 在 命令 行 下 编译 运行 ， 但 必须 把 需要 的 
JAR 文件 activation.jar 和 mail.jar 放 到 类 路 径 中 。 

编译 完成 后 ， 使 用 如 下 命令 运行 上 面 的 程序 : 

java JMailSend localhost jmailapp@domain.com javamailuser@163.com jmailapp jmailapp 
全 注意 ; 各 个 参数 的 含义 见 程序 的 分 配 。 

如 果 运 行 成 功 后 ， 会 提示 : Send 
Successfully!。 使 用 FoxMail 查看 邮件 , 效果 如 
图 12.1 所 示 。 

可 以 看 到 ， 上 面 的 代码 虽然 很 短 ， 但 却 很 
容易 地 发 送 了 邮件 ， 在 后 面 的 介绍 中 ,会 发 现 
使 用 Java 处 理 邮件 都 是 很 容易 的 。 图 12.1 ”邮件 发 送 成 功 


12.2 Java Mail API 简介 


Java Mail API 是 Sun 开发 的 最 新 标 
准 扩 展 API 之 一 ， 它 为 Java 应 用 程序 开 
发 者 提供 了 独立 于 平台 和 协议 的 邮件 / 通 


信和 解决 方案 。Java Mail API 体系 结构 如 Java 邮件 

图 122 所 示 。 
Java Mail API 提供 了 一 套 Intemet 

邮件 系统 模型 的 抽象 类 。 它 允许 Java 开 

发 者 在 软件 中 使 用 Java Mail API 提供 的 


方法 进行 邮件 的 发 送 、 接 收 和 保存 信息 
(可 以 不 考虑 信息 的 类 型 和 协议 ) 等 ， 
和 Java 的 “一 次 写成 ， 到 处 运行 ”的 编 a 
程 思想 一 致 。Java Mail API 的 核心 内 容 图 12.2 Java Mail API 体系 结构 图 
包含 在 很 少 的 几 个 主要 的 类 中 。 本 节 将 

介绍 这 些 主要 的 类 和 它们 最 常用 的 方法 。 
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1. javax.mail.Session 

javax.mail.Session 是 Java Mail API 最 高 层 入 口 类 ， 它 定义 了 一 个 基本 的 邮件 会 话 。 它 最 
常用 的 方法 是 从 java.util.Properties 类 的 实例 中 获取 相关 信息 ， 然 后 为 不 同 邮件 协议 控制 和 装 
载 SPI (Service Provider Implementation) 。 例 如 ，javax.mail.Store 是 通过 Session 类 获得 的 。 


2. javax.mail.Store 

javax.mail.Store 类 实现 特定 邮件 协议 上 的 读 、 写 、 监 视 、 查 找 等 操作 。 通 过 javax.mail.Store 
类 可 以 访问 javax.mail.Folder 类 。 

3. javax.mail.Transport 

javax.mail.Transport 类 也 是 由 服务 提供 者 提供 的 类 ， 实 现 用 特定 协议 发 送 消息 /邮件 。 
Transport 是 一 个 抽象 类 ， 它 提供 了 一 个 静态 方法 send (Message〉 用 来 发 送 邮件 。 

4. javax.mail.Folder 

javax.mail.Folder 类 用 于 分 级 组 织 邮 件 , 并 提供 按照 javax.mail.Message 格式 访问 E-mail 
的 能 力 。 

S$. javax.mail.Message 

javax.mail.Message 类 模型 化 实际 E-mail 消息 的 所 有 细节 ， 如 标题 、 发 送 /接收 地 址 、 发 
送 日 期 等 。Message 是 一 个 抽象 类 ， 它 常用 的 子 类 为 javax.mail.internet.MimeMessage。 
MimeMessage 类 是 支持 MIME 类 型 电子 邮件 消息 的 类 。 

6. javax.mail.Address 

Address 抽象 类 为 消息 中 的 地 址 建 模 ， 具 体 的 子 类 提供 详细 的 实现 细节 ， 它 实现 了 
serializable 接口 ， 最 常用 的 子 类 是 javax.mail.internet.InternetAddress。 

7. Java Mail API 与 JAF 

需要 注意 的 是 Java Mail API 实际 上 依赖 于 另外 一 个 Java 扩展 JAF， 即 JavaBeans 活动 
框架 (JavaBeans Activation Framework) 。JAF 的 目的 在 于 统一 处 理 不 同 数据 格式 的 方法 (不 
论 数 据 格 式 为 简单 文本 还 是 由 图 片 、 声 音 、 视 频 甚至 其 他 “活动 ”内 容 共 同 组 成 的 复合 文 
档 ) 。 在 这 个 意义 上 ，JAF 对 Java 的 作用 正如 插件 对 Web 浏览 器 的 作用 。 


12.3 ”使 用 Java Mail API 发送 带 附件 的 邮件 应 用 


在 本 节 中 介绍 如 何 使 用 Java Mail API 发 送 带 附件 的 邮件 ， 并 介绍 一 个 能 够 发 送 带 有 
word 文件 的 应 用 程序 。 


12.3.1 编写 程序 


在 本 小 节 编写 一 个 简单 的 程序 ， 这 个 程序 不 但 可 以 用 来 发 送 邮件 ， 可 以 指定 发 送 的 接 
收 者 ， 实 现 12.1 节 中 例子 能 实现 的 所 有 功能 ， 而 且 可 以 发 送 带 有 附件 的 邮件 。 源 代码 
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(EmailAttachBean.java) 如 下 : 


package cn.ac.ict; 

import java.io.File; 

import java.util.Properties; 
import javax.activation.*; 
import javax.mail.*; 

import javax.mail.internet.*; 


public class EmailAttachBean { 


public static void main(String[] args) { 
try{ 
// 在 命令 行 下 测试 发 送 方法 是 否 可 以 正常 运行 
new EmailAttachBean().sendAttach Message("127.0.0.1"," javamailuser@163.com", 
"jmailapp@domain.com","Hello Attachment","e:\An Introduction to the InfiniBand Architecture. 
doc"); 
}catch (Exception e) { 
e.printStackTrace(); 
} 
private void sendAttachMessage(String smtpServ, String to, 
String from,String subject, String attachment) throws Exception { 
Multipart multipart = null; 
MimeBodyPart mbp1 = null; 
MimeBodyPart mbp2 = null; 


Properties properties = System.getProperties( ); 

// 设 置 邮件 服务 器 地 址 ， 这 样 默认 的 Session 就 可 以 使 用 它 了 
properties.put("mail.smtp.host", smtpServ); 

Session session = Session.getDefaultlnstance(properties); 
// 建 一 个 新 的 消息 

Message mailMsg = new MimeMessage(session); 
InternetAddress[] addresses = null; 


try{ 
if (to != null) { 
// 如 果 收 件 人 的 地 址 不 指定 ， 就 抛 出 异常 
addresses = InternetAddress.parse(to, false); 
mailMsg.setRecipients(Message.RecipientType.TO, addresses); 
}else{ 
throw new MessagingException("The mail message requires a To' 
address."); 


名 
// 如 果 发 件 人 的 地 址 不 指定 ， 就 抛 出 异常 
if (from != nulD){ 
mailMsg.setFrom(new InternetAddress(from)); 
}else{ 
throw new MessagingException("The mail message requires a valid 'From' 
address."); 


} 
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if (subject != null) 
mailMsg.setSubject(subject); 


// 邮 件 消息 内 容 的 类 型 是 'Multipart 

/邮件 消息 的 MIME 类 型 是 'multipart/mixed' 

multipart = new MimeMultipart( ); 

/下面 介绍 邮件 消息 的 文本 部 分 

mbp1 = new MimeBodyPart( ); 

String textPart = "Hello, just thought you'd be interested in this Word file."; 
// 为 文本 部 分 消息 内 容 创 建 一 个 DataHandler 对 象 

DataHandler data = new DataHandler(textPart, "text/plain"); 

/设置 文本 MimeBodyPart 的 DataHandler 

mbp1.setDataHandler(data); 


// 把 文本 的 MimeBodyPart 加 入 到 Multipart 容器 中 
multipart.addBodyPart( mbp1); 


/创建 代表 word 附件 的 MimeBodyPart 
mbp2 = new MimeBodyPart( ); 


/创建 一 个 指向 文件 的 DataHandler 

FileDataSource fds = new FileDataSource( new File(attachment)); 
/确保 附件 被 合适 的 MIME 类 型 application/msword 处 理 
MimetypesFileTypeMap ftm = new MimetypesFileTypeMap( ); 


/语法 是 : MIME 类 型 ， 然 后 空格 ， 后 面 跟 文件 的 扩展 名 
ftm.addMimeTypes("application/msword doc DOC" ); 
fds.setFileTypeMap(ftm); 

// 使 用 刚 创建 的 FileDataSource 实例 化 DataHandler 
DataHandler fileData = new DataHandler( fds ); 


// 让 这 个 MimeMultipart 包含 刚才 的 word 文件 
mbp2.setDataHandler(fileData); 
// 为 文件 名 指定 字符 集 ， 否 则 数据 虽然 可 以 发 到 邮件 中 ， 但 是 无 法 识别 出 来 
mbp2.setFileName(MimeUtility.encodeWord(fds.getName!(),"GB2312",null)); 
// 把 包含 了 附件 的 MimeMultipart 对 象 加 到 Multipart 容器 中 
multipart.addBodyPart( mbp2 ); 


// 最 后 把 MimeMessage 的 内 容 设置 为 Multipart 对 象 
mailMsg.setContent( multipart ); 


// 发 送 邮件 
Transportsend(mailMsg); 
}catch (Exception exc){ 

throw exc; 


J 


配置 邮件 服务 器 的 地 址 、 建 立会 话 以 及 要 发 送 的 消息 ， 这 些 内 容 和 上 一 个 例子 都 是 一 
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样 的 。 但 发 送 带 有 附件 的 邮件 与 上 面 的 例子 就 有 所 不 同 了 。 带 有 附件 的 邮件 消息 分 为 两 部 
分 : 一 部 分 是 文本 消息 ， 另 一 部 分 是 附件 文件 。 这 时 ， 不 论 是 文本 消息 还 是 附件 都 要 分 别 
放 到 一 个 MimeBodyPart 对 象 中 ， 而 两 个 MimeBodyPart 对 象 再 放 到 一 个 Multipart 对 象 中 ， 

构成 一 个 完整 的 邮件 消息 ， 下 面 是 构建 文本 消息 MimeBodyPart 对 象 的 过 程 : 


/下 面 介 绍 邮件 消息 的 文本 部 分 

mbp1 = new MimeBodyPart( ); 

String textPart = "Hello, just thought you'd be interested in this Word flle."; 
// 为 文本 部 分 消息 内 容 创建 一 个 DataHandler 对 象 

DataHandler data = new DataHandler(textPart, "text/plain"); 

// 设 置 文本 MimeBodyPart 的 DataHandler 

mbp1.setDataHandler(data); 

// 把 文本 的 MimeBodyPart 加 入 到 Multipart 容器 中 

multipart.addBodyPart( mbp1); 


下 面 是 构建 word 附件 消息 的 MimeBodyPart 对 象 的 过 程 : 


/创建 代表 word 附件 的 MimeBodyPart 
mbp2 = new MimeBodyPart( ); 


/创建 一 个 指向 文件 的 DataHandler 

FileDataSource fds = new FileDataSource( new File(attachment)); 
/确保 附件 被 合适 的 MIME 类 型 application/msword 处 理 
MimetypesFileTypeMap ftm = new MimetypesFileTypeMap( ); 


/语法 是 : MIME 类 型 ， 然 后 空格 ， 岳 面 跟 文件 的 扩展 名 
ftm.addMimeTypes("application/msword doc DOC" ); 
fds.setFileTypeMap(ftm); 


/使 用 刚 创建 的 FileDataSource 实例 化 DataHandler 
DataHandler fileData = new DataHandler( fds ); 


// 让 这 个 MimeMultipart 包含 刚才 的 word 文件 
mbp2.setDataHandler(fileData); 
// 为 文件 名 指定 字符 集 ， 否 则 数据 虽然 可 以 发 到 邮件 中 ， 但 是 无 法 识别 出 来 


mbp2.setFileName(MimeUtility.encodeWord(fds.getName!(),"GB2312",null)); 


// 把 包含 了 附件 的 MimeMultipart 对 象 加 到 Multipart 容器 中 
multipart.addBodyPart( mbp2 ); 


最 好 把 两 个 MimeBodyPart 对 象 放 到 一 个 Multipart 对 象 中 后 ， 将 这 个 对 象 作为 
整 的 邮件 消息 : 


/最 后 ， 把 MimeMessage 的 内 容 设置 为 Multipart 对 象 
mailMsg.setContent( multipart ); 


最 后 就 可 以 发 送 了 。 


12.3:2 


上 面 的 程序 是 一 个 普通 的 Java 应 上 


> 二 《一 


和 运 但 


程序 并 查看 结果 


JAR 文件 activation.jar 和 mailjar 放 到 类 路 径 中 。 


-个 完 


个 元 


程序 ， 可 以 在 命令 行 下 编译 运行 ， 但 必须 把 需要 的 
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编译 完成 后 ， 使 用 如 下 命令 运行 上 面 的 程序 
java cn.ac.ict.EmailAttachBean 


程序 运行 结束 后 ， 没 有 任何 提示 消息 ， 使 用 FoxMail 查看 邮件 ， 效 果 如 图 12.3 所 示 。 
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图 12.3 ”发 送 带 附件 的 应 用 
12.4 创建 可 发 送 附 件 的 Java Mail Web 应 用 


12.4.1 Java Mail Web 应 用 的 程序 分 析 


在 这 个 Java Mail Web 应 用 中 ， 一 个 Bean 实现 了 与 邮件 服务 器 的 交互 功能 ， 还 有 两 个 
辅助 的 类 用 于 提供 一 些 有 用 的 功能 ; 一 个 用 于 配置 Log4j， 输 出 日 志 ; 其 他 的 JSP 文件 用 于 
实现 显示 部 分 的 功能 。 各 个 程序 的 作用 如 表 12.1 所 示 。 


表 12.1 Java Mail Web 应 用 各 个 程序 的 作用 


文 件 名 描述 
MailUserInfoBean.java 管理 邮件 和 邮件 文件 来， 保存 客户 信息 
JMailUtiljava 工具 集 
Log4j.java 配置 Log4j， 输 出 日 志 
ConfigLog_ In.properties Log4j 的 配置 文件 
connect.jsp 根据 客户 信息 登录 邮件 服务 器 
listall.jsp 管理 邮箱 邮件 夹 
listone.jsp 管理 邮件 夹 里 的 邮件 
showmail.jsp 显示 一 封 邮件 ， 并 对 该 邮件 进行 管理 
write ,jsp 写 新 邮件 以 及 提交 邮件 
login.jsp 客户 登录 界面 


客户 访问 Web 应 用 的 基本 流程 可 以 用 图 12.4 来 说 明 。 
12.4.2 ”邮件 账户 管理 


MailUserInfoBean.java 是 Java Mail Web 应 用 的 主要 实现 类 ， 在 这 个 程序 中 提供 了 保存 
客户 账户 和 会 话 的 信息 ， 它 是 一 个 具有 在 Session 范围 内 有 效 的 JavaBeans， 它 的 一 些 属性 
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于 连接 邮件 服务 器 或 者 保存 当前 的 会 话 信息 。 它 的 属性 如 下 : 


login.jsp connect.jsp 


显示 所 有 邮件 夹 信 息 | listalljsp 


查看 某 个 邮 
件 夹 的 信息 创建 新 邮件 夹 


删除 邮件 夹 


查看 某 个 邮 


件 的 信息 


showmail.jsp 


图 12.4 ”Java Mail Web 应 用 访问 流程 


// 客 户 连 接 邮 件 服务 器 使 用 的 URL 
URLName urlName; 
// 客 户 当前 的 会 话 
Session mailSession; 
// 客 户 使 用 的 Store 
Store store; 
// 客 户 当前 访问 的 文件 夹 
Folder currentFolder; 
// 客 户 当 前 访问 的 邮件 


Message currentMsg; 
在 这 个 类 中 分 别提 供 了 对 应 属性 的 getter 和 setter 方法 。 
MailUserInfoBean 类 提供 了 很 多 管理 邮件 的 方法 ， 如 表 12.2 所 示 。 后 面 将 选取 几 个 有 
代表 性 的 方法 讲述 其 工作 过 程 。 


表 12.2 管理 邮件 的 方法 


方 法 名 描 述 
deleteMessage 从 指定 的 邮件 夹 中 删除 指定 的 邮件 
createMessage 根据 相关 信息 构造 一 个 MIMEMessage 
sendMessage 发 送 邮件 
SaveMessage 把 邮件 保存 到 草稿 箱 中 
moveMessge 把 邮件 从 一 个 文件 夹 移动 到 另外 一 个 邮件 夹 
createTextMessage 构造 一 个 没有 附件 的 文本 邮件 消息 


createAttachMessage 


构造 一 个 能 带 附件 的 文本 邮件 消息 
删除 邮件 时 要 注意 ，Java Mail API 没 有 用 于 直接 删除 邮件 的 方法 。 要 删除 一 个 邮件 ， 
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首先 把 邮件 的 DELETED 标志 设置 为 tue， 然 后 调用 所 在 邮件 夹 的 expunge 方法 ， 把 这 个 邮 


件 夹 里 所 有 DELETED 标志 为 true 的 邮件 删除 。 而 从 Trash 中 删除 邮件 和 从 其 他 邮件 夹 删 除 


邮件 是 不 一 样 上 


和 9。 如 果 从 非 Trash 邮件 夹 删除 邮件 ， 需 要 把 


从 原来 的 邮件 夹 中 删除 邮 伯 


删除 就 可 以 了 。 


下 面 是 删除 指定 数目 邮件 的 实现 方法 : 


public int deleteMessage(int delArray[],Folder fi{ 
try{ 


for(int i=0;i<delArray.length;i++){ 


// 获 取 所 有 需要 被 删除 的 邮件 


if(delArray[l==0) continue; 

Message delMsg = f.getMessage(i+1); 

if(f.getName().equals("Trash'")){ 
Message[l] m=new Message[1]; 
ml[0] = delMsg; 

// 把 邮件 复制 到 垃圾 桶 
Folder Trash=store.getFolder("Trash"); 

f.copyMessages(m,Trash); 


// 把 邮件 设置 为 已 删除 


B 件 复制 到 Trash 邮件 夹 ， 然 后 


FEF， 而 从 Trash 邮件 夹 中 删除 邮件 就 不 需要 复制 了 ,而 只 要 把 邮件 


delMsg.setFlag(Flags.Flag.DELETED, true); 


Jelse{ 


delMsg.setFlag(Flags.Flag.DELETED, true); 


} 
} 
fexpunge(); 


}catch(Exception ef 


e.printStackTrace(); 
Log4j.logger.debug(" 删 除 邮 件 失败 ! "+e); 
return JMailUtil.FAILED; 


} 
Log4j.logger.info(" 邮 件 被 成 功 删 除 "); 
return JMailUtil.SUCCESS; 


} 


发 送 邮 件 时 需要 注意 ， 不 但 要 把 邮件 发 送 到 收 件 人 的 邮箱 中 ， 还 需要 把 发 送 的 邮件 保 
存 到 自己 的 发 件 箱 中 。 而 把 邮件 保存 到 草稿 箱 中 的 操作 和 把 邮件 保存 到 发 件 箱 类 似 。 下 面 
是 发 送 邮件 的 代码 ， 相 似 操 作 可 以 类 推 得 到 。 


public int sendMessage(Message msg){ 


/发 送 邮件 
Transport.send(msg); 
/把 邮件 保存 到 SendBox 
Folder f=store.getFolder("SendBox"); 
if(!fisOpen()) 
f.open(Folder.READ_WRITE); 
Message mll=new Message[1]; 
m[0]=msg; 
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fappendMessages(m); 

} catch (MessagingException e1){ 
lI! TODO Auto-generated catch block 
e1.printStackTrace(); 
Log4j.logger.debug(" 发 送 邮件 失败 "+e1); 

} 

Log4j.logger.info(" 发 送 邮件 成 功 !"); 

return JMailUtil.SUCCESS; 


} 

把 一 个 邮件 从 一 个 文件 夹 复制 到 另外 一 个 文件 夹 的 过 程 是 先 把 邮件 复制 到 另外 一 个 邮 
件 夹 ， 然 后 把 原来 邮件 夹 里 的 邮件 删除 ， 相 关 操 作 在 前 面 的 代码 中 有 所 涉及 ， 读 者 也 可 参 
考 光 盘 上 的 源 文件 。 
构建 邮件 消息 是 本 应 用 的 一 个 重点 ， 不 过 它 是 在 上 面 两 个 应 用 的 基础 上 修改 过 来 的 ， 
这 里 就 不 详细 介绍 了 。 


12.4.3 包含 文件 


linkjsp 是 定义 了 常用 链接 的 文件 ， 在 这 个 文件 中 定义 了 常用 的 如 查看 新 邮件 、 写 信 、 
返回 主 目录 以 及 退出 等 功能 链接 ， 方 便 用 户 浏览 。 


<%@ page contentType="text/html; charset=GB2312"%> 
<table width="55%" border=0 align =center><tr> 

<td><a href="listone.jsp?folder=INBOX"> 查 看 新 邮件 </a></td> 
<td><a href="listall.jsp"> 主 目录 </a></td> 

<td><a href="write.jsp"> 写 新 邮件 </a></td> 

<td><a href="logout.jsp"> 退 出 </a></td> 

</tr> 

</table> 


效果 如 图 12.5 所 示 。 
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图 12.5 常用 链接 


12.4.4 登录 邮件 服务 器 


Loginjsp 是 用 来 提供 登录 邮件 服务 器 的 页 面 。 在 本 例 中 要 登录 本 机 安装 的 邮件 服务 器 ， 
可 以 按照 如 下 格式 填写 (如 图 12.6 所 示 ) ， 要 确保 安装 好 了 邮件 服务 器 ， 并 建立 一 个 账户 
jmailapp， 密 人 码 jmailapp。 
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图 12.6 登录 邮件 服务 器 页 面 
用 于 提示 登录 的 页 面 Login.jsp 的 源 代码 如 下 : 


<%@ page contentType="text/html; charset=GB2312"%> 
<html><head><title>JavaMail</title></head> 
<body > 

<p><center><font face="Arial,Helvetica" font size=+3><b> 欢 迎 使 用 Java Mail Web 应 用 </b> 
</font></center></p> 
<center><img src="images\signature.gif"></center> 


<% 
String loginfail=(String)request.getAttribute("loginfail"); 
// 判 断 用 户 是 否 登 录 失 败 
if(loginfaill=null && loginfail.equals("true"))\{ 
%> 
<center><p><font color="red"> 登 录 失败 ， 请 确认 用 户 名 和 密码 后 再 重 试 ! </font></p></center> 
<% 
} 


%> 


<form action="connect.jsp" method="post" > 
<center> 
<table > 
<tr> 
<td > 用 户 名 :</td> 
<td ><input type="text" name="username" size="25" value="jmailapp"></td> 
</tr> 
<tr> 
<td > 密码 :</td> 
<td ><input type="password" name="password" size="25" value="jmailapp"></td> 
</tr> 
</table> 


</center> 

<center><br> 
<input type="reset" name="Reset" value=" 重 置 "> 
<input type="submit" value=" 提 交 "> 

</center> 

</form> 
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</body> 
</html> 


login.jsp 的 提交 页 面 是 connectjsp， 实 现 连接 的 工作 是 由 connectjsp 来 完成 的 。 它 主要 
通过 MailUserInfoBean 的 connect 方法 实现 连接 的 操作 ，connect 方法 是 实现 用 户 登 录 的 主 
体 部 分 。 它 在 MailUserInfoBean 中 的 方法 定义 如 下 : 


public int connect(String host, String user,String pass\{ 
Properties prop=null; 
prop = System.getProperties(); 
prop.put("mailtransport.protocol", "smtp"); 
prop.put("mail.store.protoco!l", "imap"); 
prop.put("mail.smtp.class", "com.sun.mail.smtp.SMTPTransport"); 
prop.put("mail.imap.class", "com.sun.mail.imap.IMAPStore"); 
prop.put("mail.smtp.host", "localhost"); 
this.mailSession = Session.getDefaultinstance(prop, null); 


try{ 
// 获取 一 个 Store 对 象 
this.store = this.mailSession.getStore("imap"); 
/使 用 Store 对 象 连接 邮件 服务 器 
this.store.connect(host,user,pass); 
Log4j.logger.info("The Store is connected!"); 

} catch (NoSuchProviderException e){ 
e.printStackTrace(); 

Log4j.logger.debug("Get a Store error!"); 
Log4j.logger.debug(e); 
return JMailUtil.FAILED; 

} catch (MessagingException e) { 
Log4j.logger.debug("Get a Store error!"); 
e.printStackTrace(); 

Log4j.logger.debug(e); 
return JMailUtil.FAILED; 


} 
// 返 回 操作 成 功 信息 
return JMailUtil.SUCCESS; 
虽然 connect 方法 提供 了 进行 连接 的 大 部 分 功能 ， 但 还 不 能 完成 基本 的 初始 化 或 保证 连 
接 的 作用 。 在 connect.jsp 中 首先 判断 客户 是 否 获得 连接 ， 如 果 没 有 连接 ， 就 要 重新 尝试 连 
接 ， 连 接 成 功 后 ， 做 一 点 简单 的 初始 化 ， 然 后 把 页 面 转 到 listalljsp〈 主 页 面 ) 。connectjsp 
的 源 代码 如 下 : 
<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import ="cn.ac.ict.JavaMail.*,javax.mail.Store"%> 
<%@ page import ="javax.mail.Folder"%> 
<%@ page import ="javax.mail.URLName"%> 
<%@ page import="java.util.*" %> 
<%@ page import= "javax.mail.”” %> 
<%@ page import="javax.mail.internet.*" %> 


第 12 章 JSP 与 Java Mail Web 应 。227。 


<%@ page import="javax.activation.*" %> 

<jsp:useBean id="userlnfo" scope="session" class="cn.ac.ict.JavaMail.MailUserlnfoBean"” /> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 

<html> 

<head> 

<title>Lomboz JSP</title> 

</head> 

<body bgcolor="#FFFFFF"> 


<% 
String hostname = "localhost";//request.getParameter("hostname"); 
String username = request.getParameter("username"); 
String password = request.getParameter("password"); 
// 连 接 邮 件 服务 器 
if(userlnfo.connect(hostname,username,password)!=JMailUtil.SUCCESSYX 
request.setAttribute("loginfail", "true"); 
out.println("get Connection error occur!"); 
%> 
<%} 
Store store = userlnfo.getStore(); 
// 判 断 是 否 已 经 连接 到 邮件 服务 器 
ifllstore.isConnected()){ 
store.connect(hostname,username,password); 
out.print("OK!"+store.isConnected()); 
} 
Folder folder=store.getFolder("Trash"); 
if(!folder.exists())folder.create(Folder.HOLDS_MESSAGES); 


folder=store.getFolder("SendBox"); 
if(!folder.exists())folder.create(Folder.HOLDS MESSAGES); 


folder=store.getFolder("Draft"); 
if(!folder.exists())folder.create(Folder.HOLDS_MESSAGES); 


folder.open(Folder.READ_WRITE); 


// 构 建 使 用 的 URL 
URLName url = new URLName("imap",hostname, -1, "inbox", username, password); 
userlnfo.setURLName(url); 
out.printIn("OK!"); 
%> 
<jsp:forward page="listall.jsp" /> 


</body> 
</html> 


12.4.5 “管理 邮件 夹 中 的 邮件 


在 listall.jsp 页 面 中 单 击 任何 一 个 邮件 夹 的 名 字 可 以 进入 管理 邮件 的 页 面 listone.jsp， 在 
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这 个 页 面 中 可 以 显示 用 户 邮 件 夹 中 邮件 的 数目 、 未 读 邮件 的 数目 以 及 所 有 邮件 的 列表 。 对 
邮件 的 管理 功能 是 可 以 删除 指定 的 邮件 ， 页 面 如 图 12.7 所 示 。 
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图 12.7 管理 邮件 夹 中 的 邮件 


通过 Message 类 的 isSet (Flags.Flag.SEEN) 可 以 判断 这 封 邮 件 是 否 被 阅读 过 ， 这 是 
个 很 有 用 的 方法 。 更 详细 的 使 用 技巧 可 以 参考 下 面 listone.jsp 的 源 代码 : 


<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import ="cn.ac.ict.JavaMail.*,javax.mail.Store"%> 
<%@ page import ="javax.mail.Folder"%> 
<%@ page import ="javax.mail.URLName"%> 
<%@ page import="java.util.*" %> 
<%@ page import="javax.mail.” %> 
<%@ page import="javax.mail.internet.*" %> 
<%@ page import="javax.activation.*" %> 
<jsp:useBean id="userlnfo" scope="session" class="cn.ac.ict.JavaMail.MailUserlnfoBean'" /> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 
<head> 
<title> 显 示 邮 件 信息 </title> 
</head> 


<body bgcolor="#FFFFFF"> 


<% 
String folderName=request.getParameter("folder"); 

Folder f=null; 

if(folderNamel=null{ 

/如 果 用 户 指定 了 邮件 夹 
f=userlnfo.getStore().getFolder(folderName); 
userlnfo.setCurrentFolder(f); 

}else{ 

// 如 果 用 户 没 有 指定 邮件 夹 ， 就 使 用 当前 的 邮件 夹 
=userlnfo.getCurrentFolder(); 
folderName=fgetName(); 
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// 如 果 邮 件 夹 没有 打开 ， 就 打开 这 个 邮件 夹 
if(!f.isOpen())f.open(Folder.READ WRITE); 
int msgCount = fgetMessageCount(); 
int unReadCount = f.getUnreadMessageCount(); 
/删除 邮件 消息 
int arrayOpt[]=new int[msgCount]; 
for(int i=1;i<=msgCount;i++}{ 
String optS=request.getParameter("dellndex"+i); 
if(optS!=null) arrayOpt[i-1]=1; 
1 
userlnfo.deleteMessage(arrayOpt,f); 
// 更 新 邮件 数 
if(f.isOpen())f.close(true); 
f.open(Folder.READ_WRITE); 
msgCount = f.getMessageCount(); 
unReadCount = f.getUnreadMessageCount(); 


%> 

<center><font size="+3"><b><%=JMailUtil.getChinese(folderName)%></b></font></center><p> 
<center><img src="images\signature.gif"></center> 

<%@ include file="link.jsp"%> 

<b> 总 邮件 数 为 :<%=msgCount%></b> 

<b> 未 读 邮 件数 为 :<%=unReadCount%></b> 


<form ACTION="listone.jsp"> 

<table cellpadding=1 cellspacing=1 width="75%" border=1 align=center> 
<tr bgcolor="ffffcc"> 

<td width="5%" ></td> 

<td width="35%" align=center><b> 发 送 者 </b></td> 

<td width="20%" align=center><b> 日 期 </b></td> 

<td width="30%" align=center><b> 主 题 </b></td> 

<td width="10%" align=center><b> 大 小 </b></td> 

</tr> 


<% 
Message m = null; 
// for each message, show its headers 
for (inti= 1;i<= msgCount; i++){ 
m = f.getMessage(i); 


/ 如 果 邮 件 是 已 被 删除 的 ， 就 不 显示 它 了 
if (m.isSet(Flags.Flag.DELETED)) 
continue; 
%> 


<%--opt --%> 
<tr valign=middle > 
<td width=5% align=center><input TYPE=CHECKBOX NAME="delIndex<%=i%>"></td> 
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<%-- from --%> 
<td width="35%" align=center> 
<% if(Im.isSet(Flags.Flag.SEEN)) out.print("<b>"); %> 
<% out.printin((m.getFrom!() != null) ? m.getFrom()[O].toString() : " "); %> 
<% if(Im.isSet(Flags.Flag.SEEN))out.print("</b>"); %> 
</td> 


<%--date --%> 

<td width="20%" align=center> 
<%if(Im.isSet(Flags.Flag.SEEN))out.printin("<b>");%> 
<%=m.getSentDate() %> 
<%if(Im.isSet(Flags.Flag.SEEN))out.printin("</b>");%> 
</td> 


<%--subject & link --%> 

<td width="30%" align=center> 

<% 

String link=" "; 

if(f.getName().equals("Draft")){ 
link="compose.jsp?edit=true"; 
userlnfo.setCurrentMsg(m); 


} 


else link="showmail.jsp" + "?messageindex=" +i; 


if(Im.isSet(Flags.Flag.SEEN))out.printIn("<b>"); 
out.println("<a href="+link+">" + 
((m.getSubject() != null)&& Im.getSubject().equals(" ")? 
m.getSubject() : "<i>No Subject</i></a>")); 
if(Im.isSet(Flags.Flag.SEEN))out.printin("</b>"); 
%> 
</td> 


<%-- Size--%> 
<td width="10%" align=center> 
<% 
if(Im.isSet(Flags.Flag.SEEN))out.printIn("<b>"); 
out.printiIn(m.getSize()+"Bytes"); 
if(Im.isSet(Flags.Flag.SEEN))out.printIn("</b>"); 
%> 
</td> 
</tr> 
<% 
} 


%> 


<p><input TYPE="SUBMIT" NAME="submit' VALUE=" 删 除 选 中 邮件 "> 
</table></form> 

</body> 

</html> 
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12.4.6 ”查看 邮件 


showmailjsp 用 于 显示 邮件 的 内 容 ， 它 根据 客户 提供 的 请 求 参 数 决定 显示 哪 封 邮件 ， 这 
个 请 求 参数 就 是 邮件 在 邮件 夹 中 的 序号 , 这 个 序号 从 1 开始 (不 是 从 0)。 下 面 是 showmailjsp 
的 源 代码 : 


<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import ="cn.ac.ict.JavaMail.*,javax.mail.Store"%> 
<%@ page import ="javax.mail.Folder"%> 
<%@ page import ="javax.mail.URLName"%> 
<%@ page import="java.util.*" %> 
<%@ page import="javax.mail.” %> 
<%@ page import="javax.mail.internet.*" %> 
<%@ page import="javax.activation.*" %> 
<%@ page import ="cn.ac.ict.*,javax.mail.Store"%> 
<%@ page import ="javax.mail.Folder"%> 
<%@ page import ="javax.mail.URLName"%> 
<%@ page import="java.util.*" %> 
<%@ page import= "javax.mail.” %> 
<%@ page import="javax.mail.internet.*" %> 
<%@ page import="javax.activation.*" %> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 

<head> 

<title> 查 看 邮件 </title> 

</head> 
<body bgcolor="#FFFFFF"> 
<jsp:useBean id="userlnfo" scope="session" class="cn.ac.ict.JavaMail.MailUserlnfoBean'" /> 


<% 
Folder folder= userlnfo.getCurrentFolder(); 
Message currmsg=null; 
int msgNum=1; 
/获取 邮件 索引 
String messageindex=request.getParameter("messageindex"); 
// 获 取 邮 件 
if(messageindex!=null}{ 
msgNum=lnteger.parselnt(messageindex); 
currmsg=folder.getMessage(msgNum); 
userlnfo.setCurrentMsg(currmsg); 
jelse 
currmsg = userlnfo.getCurrentMsg(); 
currmsg.setFlag(Flags.Flag.SEEN ,true); 
if(currmsg==nNuIIX{ 

%> 

<jsp:forward page="error.jsp" /> 

<%}%> 

<center> 

<font size="+3"><b> 
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<% outprintin(JMailUtilgetChinese(folder.getName())+” 邮 件 "); %> 
</b></font></center><p> 


<%@ include file="link.jsp"%><p> 

</center> 

<center> 

<a href="write.jsp?reply=true" > 回复 </a> 

<a href="listone.jsp?dellndex<%=msgNum%>=on" > 删除 该 邮件 </a> 


<%-- 下 面 开 始 显示 邮件 --%> 
<table width=75% align=center border=1%> 
<tr><td> 


<tr><td><b> 发 信人 :</b></td><td> <%=JMailUtil.AddressToString(currmsg.getFrom())%><br></td></tr> 
<tr><td><b> 收 信人 :</b></td><td> <%=JMailUtil.AddressToString(currmsg.getRecipients(Message. 
RecipientType.TO))%><br></td></tr> 
<tr><td><b> 抄 送 :</b> </td><td><%=JMailUtil.AddressToString(currmsg.getRecipients(Message. 
RecipientType.CC))%><br></td></tr> 
<tr><td><b> 日 期 :</b> </td><td><%=currmsg.getSentDate()%><br></td></tr> 
<tr><td><b> 主 题 :</b></td><td> <%=currmsg.getSubject()%><br></td></tr> 
<tr><td><b> 邮 件 内 容 :</b></td><td> 
<% 
out.print(currmsg); 

%><br></td></tr> 
</td></tr></table> 
</body> 
</html> 


程序 运行 的 结果 如 图 12.8 所 示 。 


收 件 箱 邮件 
回复 删除 该 邮件 
查看 新 邮件 ” 主 目 孙 ”与 新 孝 件 ”退出 


发 信和 人: nulljnailapp9127. 0.0.1 Cnull@null> 
收 信 和 人: Inullinailapp@donain, com <nulignull> 
挑 送 : 

日 期 : b 11 19:09:28 CST 2006 

主题 : 

A oom. sun. neil. inap. JMAPMeaaagegl19o4091 


到 


[BED -网 和 ar 


图 12.8 查看 邮件 的 内 容 


用 户 可 以 通过 上 面 的 链接 对 邮件 进行 操作 。 单 击 【回复 】 链 接 会 把 页 面 转 到 writejsp; 
单 击 【删除 该 邮件 】 链 接 ， 会 把 控制 权 交 给 listonejsp 来 处 理 ， 删 除 这 个 邮件 。 


12.4.7” 写 新 邮件 


writejsp 是 用 于 创建 和 发 送 邮 件 的 页 面 。 当 用 户 单 击 常用 链接 的 【 写 新 邮件 】 链 接 时 ， 
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或 当 用 户 回 复 某 个 邮件 时 ， 都 会 把 请 求 转发 到 这 个 页 面 。 这 个 页 面 的 效果 如 图 12.9 所 示 。 
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图 12.9 写 新 邮件 


在 这 个 页 面 写 好 邮件 后 , 会 提交 给 writejsp 页 面 , 对 其 进行 相应 的 操作 。 下 面 是 write.jsp 
的 源 代码 : 

<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import ="cn.ac.ict.JavaMail.*,javax.mail.Store"%> 
<%@ page import ="javax.mail.Folder"%> 
<%@ page import ="javax.mail.URLName"%> 
<%@ page import="java.util.*" %> 
<%@ page import="javax.mail.” %> 
<%@ page import="javax.mail.internet.*" %> 
<%@ page import="javax.activation.*" %> 
<%@ page import="javax.mail.Message.RecipientType" %> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 

<head> 

<title> 写 新 邮件 </title> 

</head> 
<body bgcolor="#FFFFFF"> 
<jsp:useBean id="userlnfo" scope="session" class="cn.ac.ict.JavaMail.MailUserlnfoBean'" /> 


<% 

String operation=request.getParameter("operation"); 
/下 面 获取 邮件 的 相关 信息 ， 如 发 件 人 和 收 件 人 等 
String reply=request.getParameter("reply"); 

String edit=request.getParameter("edit"); 


String to = request.getParameter("to"); 

String cc = request.getParameter("cc"); 

String bcc = request.getParameter("bcc "); 

String subj = request.getParameter("subject"); 

String text = request.getParameter("text"); 

String attachment = request.getParameter("attachment"); 
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if((operation!=null)&& (operation.equals("send"))){ 

attachment= new String(attachment.getBytes("ISO8859-1"),"GB2312"); 
Message msg = userlnfo.createMessage(to,cc,bcc,subj,text,attachment); 
// 查 看 邮件 是 否 已 经 成 功 发 送 
if(userlnfo.sendMessage(msg)==JMailUtil.SUCCESS){ 

out.println("The Mail has been sent to "+to+"!"); 
}else{ 

out.printin("The Mail sent to "+to+" Failed!"); 


} 
String sto,scc,sbcc,subject,content; 
Be 


sbcc= 
subject 
content = ”"; 

%> 

<p><center><font face="Arial,Helvetica" font size=+3><b> 写 新 邮件 </b></font></center></p> 
<center><img src="images\signature.gif"></center> 

<%@ include file="link.jsp"%> 


<form action="writejsp" method="get" enctype="multipart/form-data"> 
<table border="0" width="100%"> 
<tr> 

<td width="16%" height="22"><p align="right"><b> 收 件 人 :</b></td> 

<td width="84%"height="22"><input type="text"name="to'Value="<%=sto%>"size="30" ></td> 
</tr> 
<tr> 

<td width="16%"><p align="right"><b> 抄 送 :</b></td> 

<td width="84%"><input type="text" name="cc" value="<%=scc%>" size="30"></td> 
</tr> 
<tr> 

<td width="16%"><p align="right"><b> 暗 送 :</b></td> 

<td width="84%"><input type="text" name="bcc" value="<%=sbcc%>" size="30"></td> 
</tr> 
<tr> 

<td width="16%"><p align="right"><b> 主 题 </b></td> 

<td width="84%"><input type="text" name="subject" value="<%=subject%>" size="30"></td> 
</tr> 
<tr> 

<td width="16%">&nbsp;</td> 

<td width="84%"><textarea name="text" rows="5" cols="40"><%=content%></textarea> 
</td> 
</tr> 
<tr> 

<td width="16%"><p align="right"><b> 添 加 附件 </b></td> 

<td width="84%"> <input type="file" name="attachment"></td></tr> 
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</table> 

<center> 

<b> 
<input type="hidden" name="operation" value="send"> 
<input type="submit" name="submit" value=" 发 送 ">&nbsp; 
<input type="reset" name="reset" value=" 重 写 "> 

</center> 

</form> 

</body> 

</html> 


按照 如 图 12.9 的 输入 提交 后 ， 一 封 邮件 就 被 递送 到 jmailapp@domain.com。 如 果 使 用 
Foxmail 查看 ， 效 果 如 图 12.10 所 示 。 


文件 四 编辑 下 ) 查看 WD 邮件 吧 工具 中 


SS 3 
回复 回复 全 部 转发 | 前 一 封 。 后 一 封 打 | 蝇 除 。。 地址 小 

发 件 人 : jmsilapp8localhost 
收 件 人 : jmsilmppBdonain com 着 


区 
Nl Cb 


图 12.10 发 送 邮 件 
12.4.8 退出 系统 


logoutjsp 是 系统 的 退出 页 面 ， 结 束 会 话 。 断 开 客户 和 邮件 系统 的 链接 是 通过 以 下 语句 
实现 的 : 
String username=userlnfo.getURLName().getUsername(); 


Userlnfo.getStore().close(); 
session.invalidate(); 


12.4.9 ”发 布 Java Mail Web 应 用 


按照 上 面 的 介绍 ， 把 需要 编写 的 文件 编写 好 后 ， 应 执行 以 下 操作 : 

(1) 将 mail.jar、activation.jar 和 log4j-1.2.11.jar 文件 放 在 本 应 用 的 WEB-INF/lib 目 
及 下 < 

(2) 将 编译 使 用 到 的 Java 文件 放 在 WEB-INF/classes 目录 下 。 

把 各 种 文件 放 在 合适 的 位 置 后 ， 这 个 应 用 配置 好 的 整个 文件 夹 的 结构 如 图 12.11 所 示 。 

最 后 把 整个 JMailApp 文件 夹 复制 到 <TOMCAT_HOME>\webapps 目录 下 ， 然 后 重新 启 
动 Tomcat, 在 浏览 器 地 址 栏 中 输入 地 址 http://localhost:8080/JMailApp/loginjsp, 可 以 看 到 页 
面 显 示 如 图 12.6 所 示 。 
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人 NailUserInfoBean. class 


直 Sntphuth class 


二 login jsp 
logout. jsp 
2 shomail jsp 
write jsp 


图 12.11 Java Mail Web 应 用 程序 结构 


12. 水 结 


Java Mail API 是 Sun 开发 的 最 新 标准 扩展 API 之 一 ， 它 给 Java 应 用 程序 开发 者 提供 了 
独立 于 平台 和 协议 的 邮件 /通信 和 解决 方案 。Java Mail API 实际 上 依赖 于 另外 一 个 Java 扩展 
JAF， 即 JavaBeans 活动 框架 (JavaBeans Activation Framework) 。JAF 的 目的 在 于 统一 处 理 
不 同 数据 格式 的 方法 〈 不 论 数据 格式 为 简单 文本 还 是 由 图 片 、 声 音 、 视 频 甚 至 其 他 “活动 ” 
内 容 共 同 组 成 的 复合 文档 ) 。 在 这 个 意义 上 ，JAF 对 Java 的 作用 正如 插件 对 Web 浏览 器 的 
作用 。 

本 章 介 绍 了 Java Mail API 的 应 用 以 及 邮件 协议 的 相关 知识 ， 通 过 本 章 的 学 习 ， 读 者 对 
Java Mail API 应 该 有 比较 好 的 理解 。 本 章 还 使 用 一 个 功能 比较 齐全 的 例子 讲述 了 Java Mail 
API 的 应 用 , 在 这 个 例子 中 , 客户 可 以 使 用 这 个 应 用 收发 邮件 以 及 对 自己 的 邮箱 进行 管理 等 
各 种 操作 。 

本 章 介绍 了 如 何 发 送 文本 格式 的 邮件 、 带 附件 的 文本 格式 的 邮件 。 读 者 可 以 尝试 发 送 
HTML 格式 的 邮件 ， 这 样 多 多 练习 才能 更 好 地 掌握 Java Mail 编程 的 技巧 。 
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随 着 XML 语言 的 广泛 应 用 ， 越 来 越 多 的 应 用 中 需要 使 用 XML 进行 数据 的 交换 ， 在 使 
] JSP 技术 开发 过 程 中 同样 不 可 避免 地 要 处 理 大 量 的 XML 文档 ，JSP 技术 和 XML 技术 成 
为 开发 Web 应 用 的 两 个 很 重要 的 工具 ， 本 章 将 介绍 在 使 用 JSP 和 XML 技术 进行 开发 过 程 
中 需要 使 用 的 技术 。 


13.1 XML 与 JSP 


13.1.1 什么 是 XML 


XML 即 可 扩展 标记 语言 CeXtensible Markup Language) 。 标 记 是 指 计算 机 所 能 理解 的 
信息 符号 ， 通 过 此 种 标记 ， 计 算 机 之 间 可 以 处 理 包 含 各 种 信息 的 文章 等 。 
XML 在 写法 上 很 类 似 于 HTML, 它 属于 SGML 的 子 集 , 继承 SGML 自 定义 标记 的 优点 ， 
并 且 删 除 一 些 SGML 复杂 的 部 分 , 在 功能 上 能 够 弥补 HTML 标记 的 不 足 ,拥有 更 多 的 扩展 性 。 
不 过 XML 并 不 是 用 来 编排 内 容 的 ， 而 是 用 来 描述 数据 的 ， 它 并 没有 如 同 HTML 一 般 
的 默认 标记 ， 用 户 需要 自己 定义 描述 数据 所 需 的 各 种 标记 。 
名 注意: (1) XML 并 不 是 HTML 的 替代 产品 ， 也 不 是 HTML 的 升级 ， 它 只 是 HTML 的 
补充 ， 为 HTML 扩展 更 多 功能 。HTML 仍 将 在 较 长 的 一 段 时 间 内 继续 被 使 用 ,但 
HTML 的 升级 版 本 XHTML 的 确 正在 向 适应 XML 靠拢 。 
(2 ) 不 能 用 XML 来 直接 写 网 页 。 即便 是 包含 了 XML 数据 , 依然 要 转换 成 HTML 
格式 才能 在 浏览 器 上 显示 。 
下 面 是 一 个 很 简单 的 XML 文件 : 
<?xml version="1.0" encoding="GB2312"?> 
<user> 
<firstname>Jackie</firstname > 
<lastname>pter</lastname > 
<email>jmailappuser@163.com </email> 
<registerdate>20060115</ registerdate > 
</user> 
第 一 行 指明 这 是 一 个 XML 文件 , 版 本 为 1.0， 使 用 的 编码 类 型 为 简体 中 文 GB2312, 第 
二 行 是 根 节点 ， 根 节点 下 拥有 多 个 子 节点 ， 表 示 一 个 用 户 的 信息 。 
读者 可 以 把 这 个 文件 与 下 面 的 HTML 文件 相 比较 : 
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<!DOCTYPE HTML PUBLIC "-/W3C//DTD HTML 4.01 TransitionaWEN” 
"http://www.w3.org/TR/html4/loose.dtd"> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=gb2312"> 
<title> 用 户 信息 </title> 
</head> 


<body> 
<h1> 用 户 信息 </h1> 
<h3>firstname: Jackie</h3> 
<h3>lastname: pter</h3> 
<h3>email: jmailappuser@163.com</h3> 
<h3>registerdate: 20060115</h3> 
</body> 
</html> 


XML 文件 除了 没有 使 用 HTML 标记 以 外 ,在 结构 和 内 容 上 都 非常 相似 , 虽然 两 者 表示 
的 内 容 是 一 样 的， 都 是 用 户 的 信息 ， 但 当 在 浏览 器 中 浏览 这 两 个 页 面 时 ， 可 以 看 到 它们 是 
有 区 别 的 ，HTML 的 页 面 显示 如 图 13.1 所 示 ，XML 文件 的 页 面 显 示 如 图 13.2 所 示 。 
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<?yml version="1.0" encoding="gb2312" ?> - 
firstname: Jackie - <user> 
<firstname>Jackie</firstname> 
<lastname>pter</lastname> 
<emal>jmailappuser@163.com</email> 


lastname: pter 


email: jmailappuser@163.com <registerdate>20060115</registerdate> 


registerdate: 20060115 了 Seg 
[ED [mlm ml nll EC) 4 BE mE] 4 
图 13.1 HTML 文件 页 面 图 13.2 XML 文件 页 面 


在 HTML 文件 页 面 显 示 中 可 以 很 明确 地 知道 这 里 要 描述 一 个 用 户 的 信息 ， 但 看 XML 
文件 的 页 面 时 却 要 费 好 大 劲 才能 理解 页 面 表示 的 是 什么 内 容 , 因为 XML 文件 并 不 负责 如 何 
表示 数据 ， 它 只 是 负责 描述 数据 。 


13.1.2 XML 的 特点 


从 13.1.1 节 中 可 以 了 解 到 XML 文件 的 基本 架构 是 很 简单 的 , 除了 标记 名 称 需 要 用 户 自 
己 定义 外 ， 写 法 跟 HTML 文件 没有 什么 区 别 。XML 文件 有 几 个 特点 需要 注意 ， 下 面 分 别 介 
绍 XML 文件 的 特点 。 

1. XML 文件 是 格式 良好 的 

XML 文件 是 格式 良好 的 ， 与 HTML 文件 相 比 ，XML 文件 的 标记 都 必须 要 有 一 个 结束 
标记 ， 例 如 : 
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<email>jmailappuser@163.com </email> 

该 代码 的 开头 有 一 个 <email> 标 记 ， 末 尾 就 必须 要 有 一 个 </email> 的 结束 标记 ， 简 单 地 
说 ,标记 必须 是 成 双 成 对 的 ,如果 XML 标记 没有 内 容 , 只 有 属性 , XML 标记 的 写法 与 HTML 
的 稍 有 不 同 ， 结 束 的 “>” 符 号 前 要 有 “/” 符 号 ， 如 下 : 

<needconfirm value ="true"/> 

2. XML 文件 需要 验证 

因为 XML 文件 的 标记 是 由 用 户 自行 定义 的 ，XML 文件 并 没有 任何 默认 标记 和 架构 ， 
只 是 在 开头 声明 这 是 一 个 XML 文件 ， 所 以 要 使 用 DTD (Document Type Defination) 或 
XMLSchema 检查 XML 标记 的 定义 是 否 符合 语法 。 

XML 提供 文件 验证 的 机 制 ， 其 目的 是 检查 XML 文件 是 否 符合 自行 定义 的 标记 规则 ， 
因为 XML 的 标记 并 没有 如 同 HTML 那样 ， 已 经 替 标 记 预 先 定 义 用 途 。 例 如 : 看 到 HTML 
的 <P> 标 记 就 知道 内 含 的 文字 是 一 个 段落 ，<H> 标 记 是 标题 文字 ， 至 于 XML 的 标记 如 果 没 
有 验证 机 制 ， 那 么 文件 是 否 正 确 根 本 无 从 得 知 。 

如 果 XML 文件 主要 是 提供 网 站 内 存 或 数据 的 交换 ， 就 可 以 通过 自行 定义 的 验证 机 制 ， 
任何 人 只 需 依照 规则 编写 XML 文件 ,都 可 以 使 用 相同 的 机 制 检查 XML 文件 是 否 符合 规则 ， 
只 需 通 过 验证 就 可 以 提供 网 站 数据 或 符合 交换 数据 的 标准 格式 。 


13.1.3 XML 与 JSP 的 工具 介绍 


在 Java 语言 中 使 用 对 象 表示 数据 ，XML 是 一 个 标记 语言 ， 但 它 本 身 什么 都 不 做 ， 因 此 
Java 要 使 用 其 中 的 数据 ， 必 须要 先 解析 XML 文件 。 随 着 XML 和 Java 的 流行 ， 现 在 已 经 有 
很 多 工具 可 以 用 于 解析 和 处 理 XML 文件 。 

下 面 简 单 介 绍 几 种 常用 的 工具 ， 有 的 在 本 书 中 的 例子 中 也 会 用 到 ， 这 些 工具 大 部 分 都 
是 开放 源 代 码 的 。 

1. XSLT 

XSLT 是 扩展 样式 表 转 换 语言 (Extensible Stylesheet Language Transformations ) 的 简称 ， 
这 是 一 种 对 XML 文档 进行 转化 的 语言 ，XSLT 语言 本 身 也 是 什么 都 不 做 的 ， 它 对 XML 文 
件 的 转换 还 需要 依赖 其 他 软件 工具 的 帮助 。 

根据 W3C 的 规范 说 明 书 (http://www.w3.org/TR/xslt) ， 最 早 设计 XSLT 的 用 意 是 帮助 
XML 文档 (document) 转换 为 其 他 文档 。 但 随 着 技术 的 进步 ， XSLT 已 不 仅仅 用 于 将 XML 
转换 为 HTML 或 其 他 文本 格式 , 更 全 面 的 定义 应 该 是 : XSLT 是 一 种 用 来 转换 XML 文档 结 
构 的 语言 。 

2. JAXP 

JAXP 是 Java 语言 中 用 于 简化 XML 处 理 的 API， 它 是 Java API for XML Processing 的 
英文 字 头 缩写 ，JAXP 并 不 是 一 个 XML 文件 的 解析 器 ，JAXP 支持 DOM、SAX、XSLT 等 
标准 。 为 了 增强 JAXP 使 用 上 的 灵活 性 , 开发 者 特别 为 JAXP 设计 了 一 个 Pluggability Layer， 
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在 Pluggability Layer 的 支持 下 ，JAXP 既 可 以 和 具体 实现 DOM API、SAX API 的 各 种 XML 解 
析 器 (XML Parser， 例 如 Apache Xerces) 联合 工作 ， 又 可 以 和 具体 执行 XSLT 标准 的 XSLT 
处 理 器 (XSLT Processor， 例 如 Apache Xalan) 联合 工作 。 

读者 如 果 需 要 深入 学 习 或 下 载 相关 文档 , 可 以 访问 Sun 的 网 站 : http://java.sun.com/xml/ 
download.html。 

3. DOM 

DOM 是 Document Object Model 的 缩写 ， 即 文档 对 象 模型 。 前 面 说 过 ，XML 将 数据 组 
织 为 一 棵 树 ， 所 以 DOM 就 是 对 这 棵 树 的 一 个 对 象 描述 。 也 就 是 通过 解析 XML 文档 ， 为 
XML 文档 在 逻辑 上 建立 一 个 树 模型 ， 树 的 节点 是 一 个 个 对 象 。 程 序 员 通 过 存 取 这 些 对 象 就 
E 够 存 取 XML 文档 的 内 容 。 

4. JDOM 

JDOM 就 是 Java 与 DOM 的 结合 体 , 它 通 过 只 实现 DOM 中 最 重要 和 最 普遍 的 部 分 简化 
了 DOM,， 使 得 JDOM 使 用 起 来 更 加 简单 和 快速 ， 虽 然 它 不 具有 DOM 的 所 有 特点 ， 但 对 一 
个 Java-XML 的 开发 者 而 言 已 经 足够 了 , 读者 如 果 需 要 深入 学 习 或 下 载 相关 文档 , 可 以 访问 
网 站 : http://www.jdom.org/。 

S.SAX 

SAX 是 Simple API for XML 的 缩写 ， 它 并 不 是 由 W3C 官方 所 提出 的 标准 ， 可 以 说 是 
“民间 ”的 事实 标准 。 实 际 上 ， 它 是 一 种 社区 性 质 的 讨论 产物 。 不 同 于 DOM 的 文档 驱动 ， 
它 是 事件 驱动 的 。 它 并 不 需要 读 入 整个 文档 ， 而 文档 的 读 入 过 程 也 就 是 SAX 的 解析 过 程 。 

6. dom4j 

dom4j 是 一 个 非常 优秀 的 Java XML API， 具 有 性 能 优异 、 功 能 强大 和 极端 易于 使 用 的 
特点 ， 同 时 它 也 是 一 个 开放 源 代码 的 软件 。 如 今 越 来 越 多 的 Java 软件 都 在 使 用 dom4j 来 读 
写 XML，Sun 的 JAXM 也 在 用 dom4j。 读 者 可 以 到 如 下 网 站 下 载 dom4j: http:/dom4j. 
sourceforge.net。 


13.2 使 用 DOM 解析 接口 操作 XML 文件 


在 上 一 节 中 对 DOM 作 了 一 个 简单 的 介绍 , 在 这 一 节 就 通过 一 个 实际 的 例子 和 DOM API 
的 相关 知识 演示 如 何 使 用 DOM 解析 接口 操作 XML 文件 。 


13.2.1 DOM API 


DOM 的 基本 对 象 有 5 个 : Document、Node、NodeList、Element 和 Attr。 下 面 就 这 些 
对 象 的 功能 和 实现 的 方法 作 一 个 大 致 的 介绍 。 
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1. Document 对 象 
Document 对 象 代表 了 整个 XML 的 文档 ， 所 有 其 他 的 Node 都 以 一 定 的 顺序 包含 在 
Document 对 象 之 内 ， 排 列 成 一 个 树 型 的 结构 ， 程 序 员 可 以 通过 遍历 这 棵 树 来 得 到 XML 文 
档 的 所 有 内 容 ， 这 也 是 对 XML 文档 操作 的 起 点 。 在 实际 开发 时 总 是 先 通过 解析 XML 源 文 
件 而 得 到 一 个 Document 对 象 ， 然 后 再 来 执行 后 续 的 操作 。 此 外 ，Document 还 包含 了 创建 
其 他 节点 的 方法 ， 比 如 createAttribut0 用 来 创建 一 个 Attr 对 象 。 
它 所 包含 的 主要 方法 有 : 
口 createAttribute(String): 用 给 定 的 属性 名 创建 一 个 Attr 对 象 ， 并 可 在 其 后 使 用 
setAttributeNode 方法 来 放置 在 某 一 个 Element 对 象 上 面 。 
口 createElement(String): 用 给 定 的 标签 名 创建 一 个 Element 对 象 ， 代 表 XML 文档 中 
的 一 个 标签 ， 然 后 就 可 以 在 这 个 Element 对 象 上 添加 属性 或 进行 其 他 的 操作 。 
口 createTextNode(String): 用 给 定 的 字符 串 创建 一 个 Text 对 象 ，Text 对 象 代 表 了 标签 
或 者 属性 中 所 包含 的 纯 文本 字符 串 。 如 果 在 一 个 标签 内 没有 其 他 的 标签 那么 标签 
内 的 文本 所 代表 的 Text 对 象 是 这 个 Element 对 象 的 惟一 子 对 象 。 
口 getElementsByTagName(String): 返回 一 个 NodeList 对 象 ， 它 包含 了 所 有 给 定 标签 
名 字 的 标签 。 
口 getDocumentElement(): 返回 一 个 代表 这 个 DOM 树 的 根 节 点 的 Element 对 象 , 也 就 
是 代表 XML 文档 根 元 素 的 那个 对 象 。 
2. Node 对 象 
Node 对 象 是 DOM 结构 中 最 为 基本 的 对 象 ， 代 表 了 文档 树 中 的 一 个 抽象 的 节点 。 在 实 
际 使 用 时 ， 很 少 会 真正 地 用 到 Node 这 个 对 象 ， 而 是 用 到 诸如 Element、Attr、Text 等 Node 
对 象 的 子 对 象 来 操作 文档 ,Node 对 象 为 这 些 对 象 提供 了 一 个 抽象 的 、 公 共 的 根 ,虽然 在 Node 
对 象 中 定义 了 对 其 子 节点 进行 存 取 的 方法 ， 但 有 一 些 Node 子 对 象 ， 比 如 Text 对 象 ， 它 并 
不 存在 子 节点 ， 这 一 点 是 要 注意 的 。Node 对 象 所 包含 的 主要 方法 有 : 
口 appendChild(org.w3c.dom.Node): 为 这 个 节点 添加 一 个 子 节 点 ， 并 放 在 所 有 子 节点 
的 最 后 ， 如 果 这 个 子 节点 已 经 存在 ， 则 先 把 它 删 掉 再 添加 进去 。 
口 getFirstChild0: 如 果 节 点 存在 子 节点 ， 则 返回 第 一 个 子 节点 ， 相 应 地 ， 还 有 
getLastChild() 方 法 返回 最 后 一 个 子 节点 。 
getNextSibling0: 返回 在 DOM 树 中 这 个 节点 的 下 一 个 兄弟 节点 ， 相 应 地 ， 还 有 
getPreviousSibling() 方 法 返回 其 前 一 个 兄弟 节点 。 
getNodeName(): 根据 节点 的 类 型 返回 节点 的 名 称 。 
getNodeType0: 返回 节点 的 类 型 。 
getNodeValue(): 返回 节点 的 值 。 
hasChildNodes(): 判断 是 否 存 在 子 级 节点 。 
hasAttributes0: 判断 这 个 节点 是 否 具 有 带 有 指定 名 称 的 属性 。 
getOwnerDocument0: 返回 节点 所 处 的 Document 对 象 。 
insertBefore(org.w3c.dom.Node new，org.w3c.dom.Node ref): 在 给 定 的 一 个 子 对 象 


口 


口 口 口 口 品 日 口 
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前 再 插入 一 个 子 对 象 。 

口 removeChild(org.w3c.dom.Node): 删除 给 定 的 子 节点 对 象 。 

口 replaceChild(org.w3c.dom.Node new，org.w3c.dom.Node old): 用 一 个 新 的 Node 对 
象 代替 给 定 的 子 节点 对 象 。 
3. NodeList 对 象 
NodeList 对 象 ， 是 代表 一 个 包含 了 一 个 或 者 多 个 Node 对 象 的 列表 ， 可 以 简单 地 把 它 看 
成 一 个 Node 的 数组 。 可 以 通过 下 列 两 种 方法 来 获得 列表 中 的 元 素 : 
口 GetLength(0): 返回 列表 的 长 度 。 
口 Item(int): 返回 指定 位 置 的 Node 对 象 。 
4. Element 对 象 
Element 对 象 代表 的 是 XML 文档 中 的 标签 元 素 ， 继 承 于 Node， 亦 是 Node 的 最 主要 的 
子 对 象 。 在 标签 中 可 以 包含 有 属性 , 因而 Element 对 象 中 有 存 取 其 属性 的 方法 , 而 任何 Node 
中 定义 的 方法 ， 也 可 以 用 在 Element 对 象 上 面 。 
口 getElementsByTagName(String): 返回 一 个 NodeList 对 象 ， 它 包含 了 在 这 个 标签 中 
其 下 的 子孙 节点 中 具有 给 定 标签 名 字 的 标签 。 

口 getTagName(): 返回 一 个 代表 这 个 标签 名 字 的 字符 串 。 

口 getAttribute(String): 返回 标签 中 给 定 属性 名 称 的 属性 的 值 。 需 要 注意 的 是 ， 因 为 
XML 文档 中 允许 有 实体 属性 出 现 ， 而 这 个 方法 对 这 些 实体 属性 并 不 适用 。 这 时 需 
要 用 到 getAttributeNodes() 方 法 得 到 一 个 Attr 对 象 来 进行 进一步 的 操作 。 

口 getAttributeNode(String): 返回 一 个 代表 给 定 属性 名 称 的 Attr 对 象 。 

S。Attr 对 象 

Attr 对 象 代表 某 个 标签 中 的 属性 。Attr 继承 于 Node, 但 因为 Attr 实际 上 是 包含 在 Element 
中 的 , 它 并 不 能 被 看 作 是 Element 的 子 对 象 , 因而 在 DOM 中 Attr 并 不 是 DOM 树 的 一 部 分 ， 
所 以 Node 中 的 getparentNode()、getpreviousSibling() 和 getnextSibling() 返 回 的 都 将 是 null。 
也 就 是 说 ，Attr 其 实 是 被 看 作 包 含 它 的 Element 对 象 的 一 部 分 ， 它 并 不 作为 DOM 树 中 单独 

4 一 个 节点 出 现 。 这 一 点 在 使 用 时 要 同 其 他 的 Node 子 对 象 相 区 别 。 

上 面 所 说 的 DOM 对 象 在 DOM 中 都 是 用 接口 定义 的 , 在 定义 时 使 用 的 是 与 具体 语言 无 
关 的 IDL 语言 来 定义 的 。 因 而 ，DOM 其 实 可 以 在 任何 面向 对 象 的 语言 中 实现 ， 只 要 它 实 现 
了 DOM 所 定义 的 接口 和 功能 就 可 以 了 。 同 时 ， 有 些 方法 在 DOM 中 并 没有 定义 ， 是 用 IDL 
的 属性 来 表达 的 ， 当 被 映射 到 具体 的 语言 时 ， 这 些 属 性 被 映射 为 相应 的 方法 。 


13.2.2 ”使 用 DOM 读 写 XML 文件 的 例子 


下 面 介绍 一 个 使 用 DOM 读 写 XML 文件 的 例子 ， 读 者 可 以 按照 下 面 介 绍 的 步骤 开发 这 
个 例子 。 
1. 编写 XML 文件 

下 面 编写 一 个 books.xml 文件 , 在 这 个 文件 中 有 很 多 本 书 的 信息 , 在 后 面 介绍 JDOM 和 


第 13 章 XML 在 JSP 中 的 应 “243 。 


SAX 技术 时 也 使 用 这 个 XML 文件 。books.xml 文件 的 内 容 如 下 : 


<?xml version="1.0" encoding="gb2312"?> 
<books> 
<book> 
<title>JSP 应 用 开发 指南 </title> 
<url newWindow="no">http://java.sun.com</url> 
<author>Author 001</author> 
<date> 
<day>23</day> 
<month>1</month> 
<year>2006</year> 
</date> 
<description> 一 本 详尽 介绍 JSP 技术 的 书 </description> 
</book> 


<book> 
<title>Ant 技术 详解 </title> 
<url newWindow="no">http://ant.apache.org/</url> 
<author>Author 002</author> 
<date> 
<day>23</day> 
<month>1</month> 
<year>2006</year> 
</date> 
<description> 一 本 详尽 介绍 Ant 技术 的 书 </description> 
</book> 


<book> 
<title>Apache 技术 详解 </title> 
<url newWindow="no">http://www.apache.org/</url> 
<author>Author 003</author> 
<date> 
<day>23</day> 
<month>1</month> 
<year>2006</year> 
</date> 
<description> 一 本 详尽 介绍 Apache 技术 的 书 </description> 
</book> 


</books> 

2. 编写 读 写 XML 文档 的 JSP 页 面 

准备 好 要 读 写 的 XML 文件 后 ， 就 可 以 开始 编写 读 写 XML 文档 的 JSP 页 面 了 ， 下 面 是 
读 写 XML 文件 的 JSP 页 面 (DOMExamplejsp) ， 代 码 如 下 : 

<%@ page language="java" pageEncoding="GB2312" %> 

<%@ page import="javax.xml.parsers.*"%> 


<%@ page import="org.w3c.dom.*"%> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
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<html> 
<head> 
<tile>DOM 操作 XML 文件 JSP</title> 
</head> 
<body bgcolor="#FFFFFF"> 
<% 
// 建 立 一 个 解析 器 工厂 
DocumentBuilderFactory factory = DocumentBuilderFactory.newlnstance(); 
// 获 得 一 个 具体 的 解析 器 对 象 
DocumentBuilder builder=factory.newDocumentBuilder(); 
// 对 XML 文档 进行 解析 ， 获 得 Document 对 象 
Document doc=builder.parse("C:/Tomcat 5.0/webapps/13/books.xm!"); 
doc.normalize(); 
// 获 取 所 有 的 book 元 素 列表 
NodeList books = doc.getElementsByTagName("book"); 
%> 
<h2> 图 书 列表 </h2><br> 
<% 
for (int i=0;i<books.getLength();i++){ 
// 获 取 一 个 book 元 素 
Element book=(Element) books.item(i); 
/以 下 获取 book 的 子 元 素 ， 并 输出 
out.print("title: "); 


out.printin(book.getElementsByTagName("title").item(0).getFirstChild().getNodeValue()); 
out.print("<br>"); 

out.print("URL: "); 
out.printin(book.getElementsByTagName("url").item(0).getFirstChild().getNodeValue!()); 
out.print("<br>"); 

out.print("Author: "); 


out.printin(book.getElementsByTagName("author").item(0).getFirstChild().getNodeValue()); 
out.print("<br>"); 

out.print("Date: "); 

Element bookdate=(Element) book.getElementsByTagName("date").item(0); 

String day=bookdate.getElementsByTagName("day").item(0).getFirstChild().getNodeValue!(); 
String month=bookdate.getElementsByTagName("month").item(0).getFirstChild().getNodeValue(); 
String year=bookdate.getElementsByTagName("year").item(0).getFirstChild().getNodeValue(); 
out.printiIn(day+"-"+month+"-"+year); 

Out.print("<br>"); 

out.print("Description: "); 


out.printin(book.getElementsByTagName("description").item(0).getFirstChild().getNodeValue()); 
out.print("<br>"); 
out.print("<br>"); 
} 
%> 
</body> 
</html> 
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要 读 取 XML 文件 的 内 容 , 首先 要 把 XML 文件 的 内 容 解 析 为 一 个 个 的 对 象 供 程 序 使 用 ， 
这 需要 建立 一 个 解析 器 工厂 ， 以 利用 这 个 工厂 来 获得 一 个 具体 的 解析 器 对 象 : 
DocumentBuilderFactory factory = DocumentBuilderFactory.newlnstance(); 


使 用 DocumentBuilderFactory 的 目的 是 为 了 创建 与 具体 解析 器 无 关 的 程序 , 当 Document 
BuilderFactory 类 的 静态 方法 newInstance() 被 调用 时 ， 它 根据 一 个 系统 变量 来 决定 具体 使 用 
哪 一 个 解析 器 。 又 因为 所 有 的 解析 器 都 服从 于 JAXP 所 定义 的 接口 , 所 以 无 论 具 体 使 用 哪 一 
个 解析 器 ， 代 码 都 是 一 样 的 。 因 此 当 在 不 同 的 解析 器 之 间 进 行 切换 时 ， 只 需要 更 改 系统 变 
量 的 值 ， 而 不 用 更 改 任何 代码 。 这 就 是 工厂 所 带 来 的 好 处 。 

DocumentBuilder builder=factory.newDocumentBuilder(); 

当 获 得 一 个 工厂 对 象 后 ， 使 用 它 的 静态 方法 newDocumentBuilder() 可 以 获得 一 个 
DocumentBuilder 对 象 ， 这 个 对 象 代 表 了 具体 的 DOM 解析 器 。 但 具体 是 哪 一 种 解析 器 对 于 
程序 而 言 并 不 重要 。 

然后 ， 就 可 以 利用 这 个 解析 器 来 对 XML 文档 进行 解析 了 : 

Document doc=builder.parse("C:/Tomcat 5.0/webapps/13/books.xml"); 

doc.normalize(); 

DocumentBuilder 的 parse() 方 法 接受 一 个 XML 文档 名 作为 输入 参数 ， 返 回 一 个 
Document 对 象 ， 这 个 Document 对 象 就 代表 了 一 个 XML 文档 的 树 模型 。 以 后 所 有 对 XML 
文档 的 操作 都 与 解析 器 无 关 ， 直 接 在 这 个 Document 对 象 上 进行 操作 就 可 以 了 。 而 具体 对 
Document 操作 的 方法 是 由 DOM 所 定义 的 ， 这 在 13.2.1 节 中 已 经 介绍 了 。 


全 注意 ; 对 Document 对 象 调用 normalize(0)， 可 以 去 掉 XML 文档 中 作为 格式 化 内 容 的 空白 
而 映射 在 DOM 树 中 的 不 必要 的 Text Node 对 象 . 否则 得 到 的 DOM 树 可 能 并 不 如 
所 想象 的 那样 。 特 别 是 在 输出 时 ， 这 个 normalize() 更 为 有 用 。 
XML 文档 中 的 空白 符 也 会 被 作为 对 象 映 射 在 DOM 树 中 。 因 而 ， 直 接 调用 Node 方法 
的 getChildNodes 方法 有 时 会 有 些 问题 ， 有 时 不 能 够 返回 所 期 望 的 NodeList 对 象 。 解 决 的 办 
法 是 使 用 Element 的 getElementByTagName(String)， 返 回 的 NodeList 就 是 所 期 待 的 对 象 了 。 
然后 可 以 用 item() 方 法 提取 想 要 的 元 素 。 
NodeList books = doc.getElementsByTagName("book"); 
%> 
和 
<% 
for (int i=0;i<books.getLength();i++){ 
Element book=(Element) books.item(i); 


把 books.xml 文件 和 DOMExample.jsp 文件 复制 到 本 章 的 Web 应 用 目录 下 ,然后 在 浏览 
器 地 址 栏 中 输入 如 下 地 址 :http://localhost:8080/13/DOMExample.jsp， 可 以 看 到 页 面 显示 如 
图 13.3 所 示 。 
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图 13.3 DOM 读 取 XML 文件 


13.3 使 用 JDOM 操作 XML 文件 


13.3.1 JDOM 的 安装 与 简介 


1. JDOM 的 安装 

由 于 JDOM 不 是 J2SE 的 一 部 分 ， 因 此 如 果 要 使 用 JDOM 读 写 XML 文件 ， 需 要 到 
http://jdom.org 下 载 JDOM 的 类 库 。 

目前 JDOM 的 最 新 版 本 是 1.0, 将 下 载 的 压缩 包 解 压缩 后 ,把 解压 build 目录 下 的 jdomjar 
和 1lib 目录 下 的 antjar、jaxen-core.jar、jaxen-jdom.jar、saxpath.jar、xalan.jar、xerces.jar、 xml-apis. 
jar 文件 复制 到 Web 应 用 的 WEB-INF\lib 目录 下 。 

2. JDOM 简介 

JDOM 的 处 理 方式 有 些 类 似 于 DOM， 但 它 主 要 是 用 SAX 实现 的 ， 不 需要 担心 处 理 速 
度 和 内 存 的 问题 。 另 外 ，JDOM 中 的 接口 很 少 ， 全 部 是 类 ， 也 没有 类 工厂 类 。 其 最 重要 的 
一 个 包 org.jdom 中 主要 有 以 下 类 : 
Attribute 
CDATA 
Comment 
DocType 
Document 
Element 
EntityRef 
Namespace 
ProcessingInstruction 


DoOOOOOOOODO 


Text 


这 些 对 象 和 XML 文件 中 的 元 素 是 一 一 对 应 的 , 这 里 就 不 详细 介绍 了 , 读者 可 以 在 仔细 
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了 解 XML 文件 的 基础 上 熟悉 这 些 类 的 使 用 。 
各 注意 : 数据 输入 要 用 到 XML 文档 ， 需 要 orgjdom.input 包 ， 反 过 来 需要 orgjdom.output 包 。 


13.3.2 ”使 用 JDOM 读 写 XML 文件 


1. 编写 XML 文件 

在 本 例 中 使 用 13.2.2 节 中 编写 的 XML 文件 books.xml， 这 里 就 不 作 介绍 了 。 

2. 编写 读 写 XML 文档 的 JSP 页 面 

准备 好 要 读 写 的 XML 文件 后 ， 就 可 以 开始 编写 读 写 XML 文档 的 JSP 页 面 了 ， 下 面 是 
读 写 XML 文件 的 JSP 页 面 (JDOMExample.jsp) ， 代 码 如 下 : 


<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import="java.io.*"%> 

<%@ page import="java.util.”"%> 

<%@ page import="org.jdom.*"%> 

<%@ page import="org.jdom.output.”%> 
<%@ page import="org.jdom.input.”"%> 
<%@ page import="javax.servlet.http.”"%> 


<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 
<head> 
<title>DOM 操作 XML 文件 JSP</title> 
</head> 
<body bgcolor="#FFFFFF"> 
<% 
Vector xmlVector = null; 


FilelnputStream fi = null; 


try{ 

// 建 立 文件 输入 流 
fi= new FilelnputStream("C:/Tomcat 5.0/webapps/13/books.xm!"); 
xmlVector = new Vector(); 

// 得 到 一 个 解析 器 对 象 
SAXBuilder sb = new SAXBuilder(); 

// 解 析 XML 文件 ， 获 取 一 个 Document 对 象 
Document doc = sb.build(fi); 

// 得 到 根 元 素 
Element root = doc.getRootElement(); 

// 得 到 根 元 素 所 有 子 元 素 的 集合 
List books = root.getChildren(); 
Element book =null; 
out.print("<h2> 图 书 列表 </h2><br>"); 
for(int i=0;i<books.size();i++X{ 

// 得 到 一 本 书 元 素 
book = (Element)books.get(i); 
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// 获 取 子 元 素 ， 并 输出 。 
out.print("title: "); 
out.print(book.getChild("title").getText()); 
out.print("<br>"); 
out.print("URL: "); 
out.print(book.getChild("url").getText()); 
out.print("<br>"); 
out.print("Author: "); 
out.print(book.getChild("author").getText()); 
out.print("<br>"); 
out.print("Date: "); 
Element bookdate=book.getChild("date"); 
String day=bookdate.getChild("day").getText(); 
String month=bookdate.getChild("month").getText(); 
String year=bookdate.getChild("year").getText(); 
out.printin(day+"-"+month+"-"+year); 
out.print("<br>"); 
out.print("Description: "); 
out.print(book.getChild("description").getText()); 
out.print("<br>"); 
out.print("<br>"); 


}catch(Exception ex){ 


} 


%> 


</body> 
</html> 
要 读 取 XML 文件 的 内 容 , 首先 要 把 XML 文件 的 内 容 解析 为 一 个 个 的 对 象 供 程序 使 用 。 
在 使 用 DOM 读 写 XML 文件 时 ， 首 先 建 立 一 个 工厂 对 象 ， 通 过 工厂 对 象 获取 一 个 解析 器 ， 
然后 把 XML 文件 解析 为 一 个 Document 对 象 。 但 在 使 用 JDOM 时 就 不 是 这 样 了 ， 它 是 把 
XML 文件 作为 输入 流 ， 然 后 建立 一 个 SAX 的 解析 器 ,将 其 解析 为 一 个 Document 对 象 ， 代 
码 如 下 : 
fi= new FilelnputStream("C:/Tomcat 5.0/webapps/13/books.xm!"); 
xmlVector = new Vector(); 
SAXBuilder sb = new SAXBuilder(); 
Document doc = sb.build(fi); 
得 到 XML 文件 的 Document 对 象 后 就 可 以 得 到 文件 的 根 元 素 和 根 元 素 下 的 所 有 子 元 素 ， 
然后 对 这 些 子 元 素 进行 循环 解析 就 可 以 了 。 
Element root = doc.getRootElement(); /得 到 根 元 素 
List books = root.getChildren(); // 得 到 根 元 素 所 有 子 元 素 的 集合 
Element book =null; 
out.print("<h2> 图 书 列表 </h2><br>"); 
for(int i=0;i<books.size();i++}{ 
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13.4 使 用 SAX 操作 XML 文件 


在 本 节 中 介绍 使 用 SAX 操作 XML 文件 ， 由 于 SAX 减少 了 对 内 存 的 需求 ， 因 而 成 为 很 
多 技术 行家 推崇 使 用 的 技术 。 


13.4.1 


1, 


SAX API 


SAX 事件 


以 下 SAX 事件 是 被 经 常用 到 的 ， 它 们 都 在 org.xml.sax 包 的 HandlerBase 类 中 被 定义 。 


口 
目 
口 


口 
口 


startDocument: 表示 文档 开始 。 

endDocument: 表示 文档 结束 。 

startElement: 表示 元 素 开 始 。 当 一 对 标记 中 的 起 始 标记 中 的 所 有 内 容 被 处 理 后 ， 解 
析 器 激发 此 事件 。 包 括 了 标记 名 和 其 属性 。 

endElement: 表示 元 素 结束 。 

characters: 包含 字符 数据 ， 类 似 于 DOM 的 一 个 Text 节点 。 


还 有 一 些 其 他 的 SAX 事件 : 


口 


口 


口 


2. 


ignorableWhitespace: 此 事件 类 似 于 前 面 所 讨论 的 无 用 DOM 节点 。 它 与 character 
事件 相 比 ， 好 处 是 : 如 果 不 需 要 空格 符 ， 开 发 者 可 以 通过 忽略 这 个 事件 来 忽略 所 有 
的 空格 符 。 

warning、error 和 fatalError 这 3 个 事件 表示 了 解析 错误 。 开 发 者 可 根据 需要 来 响应 
它们 。 

setDocumentLocator: 这 个 事件 允许 存储 一 个 SAX 的 Locator 对 象 。Locator 对 象 可 
以 用 来 找 出 在 文档 中 确切 发 生 事件 的 地 方 。 

SAX 处 理 的 工作 过 程 


SAX 是 基于 事件 的 一 种 处 理 XML 文件 的 机 制 ， 下 面 简单 介绍 SAX 处 理 的 工作 过 程 。 
SAX 分 析 经 过 其 XML 流 , 这 非常 像 老 式 的 自动 收报 机 纸 条 。 考 虑 以 下 XML 代码 片断 : 
<?xml version="1.0"?> 

<samples> 

<server>UNIX</server> 

<monitor>color</monitor> 

</samples> 


SAX 处 理 器 分 析 这 段 代 码 将 生成 以 下 事件 : 


口 
口 
口 
口 


Start document 

Start element (samples) 
Characters (white space) 
Start element (server) 
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Characters (UNIX) 

End element (server) 
Characters (white space) 
Start element (monitor) 
Characters (color) 

End element (monitor) 


Characters (white space) 


DOOOOODODO 


End element (samples) 
SAX API 允许 开发 者 捕获 这 些 事件 ， 并 对 它们 进行 操作 。SAX 处 理 涉及 以 下 几 步 : 
(1) 创建 事件 处 理 程序 。 
(2) 创建 SAX 解析 器 。 
(3) 将 事件 处 理 程序 分 配给 解析 器 
(4) 对 文档 进行 解析 ， 将 每 个 事件 发 送 给 处 理 程 序 。 


13.4.2 ”使 用 SAX 读 写 XML 文件 


下 面 介 绍 一 个 使 用 SAX 读 XML 文件 的 例子 ， 在 这 个 例子 中 解析 一 个 XML 文件 ， 并 
把 文件 的 内 容 输出 到 JSP 页 面 上 。 
.编写 XML 文件 
在 本 例 中 使 用 13.2 节 中 编写 的 XML 文件 books.xml， 这 里 就 不 作 介绍 了 。 
下 面 编 写 一 个 Book Bean， 它 可 以 用 来 存 取 一 个 book 对 象 的 信息 ， 并 提供 相应 的 get 
和 set 方法 ， 由 于 它 的 属性 都 是 Simple 的 ， 所 以 这 里 也 不 作 详 细 介 绍 ， 读 者 有 疑问 可 以 参 
考 本 书 “JavaBeans 在 JSP 中 的 应 用 ”一 章 中 的 介绍 。 下 面 是 BookBean.java 的 源 代码 : 


package cn.ac.ict; 


public class BookBean { 
private String title = " "; 
private String author = " "; 
private String url =" "; 
private String day = " "; 
private String month = " "; 
private String year = " "; 
private String daca ="", 


public void setTitle(String newtitle){ 
this.title = newtitle; 

} 

public void setAuthor(String newauthor){ 
this.author = newauthor'; 

b 

public void setUrl(String newur){ 
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this.url = newurl; 

} 

public void setDay(String newday}{ 
this.day = newday; 

public void setMonth(String newmonthj{ 
this.month = newmonth; 

} 

public void setYear(String newyear){ 
this.year = newyear; 

9 

public void setDescription(String descr){ 
this.description = descr; 

i 

public String getTitle(){ 
return thistitle; 

public String getAuthor(){ 
return this.author; 

public String getUrl(){ 
return this.url; 

} 

public String getDescription(){ 
return this.description; 

} 

public String getDate(){ 
return this.day+"-"+this.month+"-"+this.year; 

} 

L 


2. SAXHandlerBean.java 文件 

SAXHandlerBean 是 对 XML 文件 进行 解析 的 一 个 类 ， 这 个 类 扩展 了 ContentHandler 接 
SAXHandlerBean 类 必须 实现 ContentHandler 接口 中 的 方法 。 

下 面 是 SAXHandlerBean 类 的 源 代码 : 

package cn.ac.ict; 

import java.io.IOException; 


import java.util.Enumeration; 
import java.util.Hashtable; 


import javax.servlet.http.HttpServletRequest'; 


import org.xml.sax.”*; 
import org.xml.sax.helpers.XMLReaderFactory; 


public class SAXHandlerBean implements ContentHandler { 
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private Hashtable table = new Hashtable(); 
private BookBean book = null; 

private Locator locator; 

private String currentvalue; 


public SAXHandlerBean() { 
super(); 


} 
// 解 析 XML 文件 
public void parseXML(String uri) { 
try{ 
System.out.printin(" 正 在 分 析 中 的 XML 文件 :" + uri + "\n"); 
XMLReaderparser =XMLReaderFactory.createXMLReader("org.apache.xerces. 
parsers.SAXParser ); 
/XMLReader parser = new SAXParser(); 
/注册 自己 设计 的 内 容 处 理 器 
parser.setContentHandler(this); 
// 注 册 错 误 处 理 器 
parser.setErrorHandler(new SAXErrorHandler()); 
// 分 析 文件 
parser.parse(uri); 
} catch(IOException ioeif 
System.out.println(" 文 件 读 取 错 误 : "+ioe.getMessage()); 
} catch(SAXException saxe){ 
System.out.printin("XML 分 析 错 误 : “+saxe.getMessage()); 
} 
} 
public static void main(String[] args) { 
Hashtable table = new Hashtable(); 
// 如 果 参 数 数目 不 对 ， 则 输出 使 用 说 明 ， 并 结束 程序 
if( args.length != 1 X{ 
System.out.println(" 请 输入 欲 分 析 的 文件 名 : " +"java MySAXParser [XML URIJ"); 
System.exit(-1); 
1 
String uri = args[0]; 
SAXHandlerBean myParser = new SAXHandlerBean(); 
myParser.parseXML(uri); 
table = myParser.getTable(); 
Enumeration enum = table.keys(); 
while(enum.hasMoreElements()){ 
String booktitle = (String)enum.nextElement(); 
BookBean book = (BookBean)table.get(booktitle); 
System.out.print(book.getDescription()); 
1 


public void setTable(Hashtable table){ 
this.table = table; 


} 
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public void getTable(HttpServletRequest request}{ 
request.getSession().setAttribute("books",table); 
bs 
public Hashtable getTable(}{ 
return this.table; 
} 
public void setDocumentLocator (Locator locatorj{ 
System.out.println(" 设 置 Locator 对 象 .…"); 
// 把 SAX 的 Locator 对 象 放 到 我 们 自己 的 Locator 对 象 中 
this.locator = locator 


} 


public void startDocument() throws SAXException{ 
System.out.println(" 文 件 分 析 开 始 ->"); 
} 


public void endDocument()throws SAXException{ 
table.put(book.getTitle(),book); 
System.out.printIn("<- 文 件 分 析 结 束 "); 

} 


public void startPrefixMapping (String prefix, String uri) throws SAXException{ 
System.out.printIn( "命名 空间 对 应 开始 ->" + "第 " + locator.getLineNumber() + " 行 " + "\n\t 命名 
空间 前 导 符 : " + prefix + "nt 相对 应 的 统一 资源 标识 符 :" + uri); 


public void endPrefixMapping (String prefix) throws SAXException{ 
System.outprintin("<- 命 名 空间 对 应 结束 " ); 


public void startElement (String namespaceUR!I, String localName, String qName, Attributes 
atts) throws SAXException{ 
System.out.print(" 元 素 开始 : " + localName); 
if(namespaceURI.equals(" ")) { 
namespaceURI = "没有 命名 空间 "; 


} 
System.out.println("， 命 名 空间 : " + namespaceURI +"， 限 定名 : " + qName + "."); 
// 打 印 属性 


for(int i=0; i<atts.getLength(); i++) 
System.out.printiIn("\t 属性 名 称 : " + atts.getLocalName(i) + 
"="+ atts.getValue(i) + "."); 
if(local Name.equals("book")}{ 
if(bookl=null{ 
table.put(book.getTitle(),book); 
} 
book = new BookBean(); 
1 
} 
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public void endElement (String namespaceURI, String localName,String qName) throws 
SAXException{ 
System.out.print(" 元 素 结束 : " + localName); 
if(namespaceURI.equals(" ")) { 
namespaceURI = "没有 命名 空间 "; 
} 
System.outprintin("， 命 名 空间 : " + namespaceURI +"， 限 定名 :" + qName + "."); 

if(local Name.equals("title")){ 
book.setTitle(currentvalue); 

} 

if(local Name.equals("urI")){ 
book.setUrl(currentvalue); 

1 

if(local Name.equals("author")}{ 
book.setAuthor(currentvalue); 

} 

if(localName.equals("day"))\{ 
book.setDay(this.currentvalue); 

ly 

if(localName.equals("month")X{ 
book.setMonth(this.currentvalue); 

1 

if(localName.equals("year")\{ 
book.setYear(this.currentvalue); 

} 

if(localName.equals("description")X{ 
book.setDescription(this.currentvalue); 

} 

} 


public void characters (char ch[], int start, int length) throws SAXException{ 
String charData = new String(ch, start, length); 
System.out.printin(" 字 符 数据 : \" "+ charData + \""); 
currentvalue = charData; 


} 


public void ignorableWhitespace (char ch[], int start, int length) throws SAXException{ 
String whiteSpace = new String(ch, start, length); 
System.outprintin(" 空 格 符 : "+ whiteSpace + \" "); 
} 


public void processinglnstruction (String target, String data) throws SAXException{ 
System.out.println(" 处 理 命令 ”目标 (target):" + target+ ”和 其 数据 (data):" + data); 
} 


public void skippedEntity (String name)throws SAXException{ 
System.out.printIn(" 忽 略 的 实体 : " + name); 
} 

| 


SAXHandlerBean 在 解析 文件 之 前 ， 使 用 工厂 利用 一 个 指定 的 类 名 创建 一 个 解析 器 : 
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XMLReader parser =XMLReaderFactory.createXMLReader("org.apache.xerces. 
parsers.SAXParser ); 

然后 分 别 注 册 内 容 处 理 器 和 错误 处 理 器 : 

/注册 自己 设计 的 内 容 处 理 器 
parser.setContentHandler(this); 
/注册 错误 处 理 器 
parser.setErrorHandler(new SAXErrorHandler()); 
全 注意 ; 这 里 的 内 容 处 理 器 就 是 这 个 对 象 本 身 ， 因 为 这 个 类 扩展 了 ContentHandler 接口 ， 
具有 内 容 处 理 的 能 力 。 

最 后 分 析 文 件 的 内 容 : 

/分 析 文件 
parser.parse(uri); 

当 解 析 器 在 分 析 文 件 时 ， 会 遇 到 不 同 的 元 素 或 者 属性 ， 当 遇 到 一 个 元 素 的 开始 或 结束 
标志 时 都 会 触发 一 个 事件 ， 并 由 内 容 处 理 器 中 相应 的 方法 进行 处 理 。 

在 这 个 内 容 处 理 器 类 中 , 把 所 有 的 book 元 素 集合 为 一 个 book 对 象 , 然后 把 所 有 的 book 
对 象 存储 在 一 个 Hashtable 对 象 中 ， 并 提供 了 两 个 方法 用 于 获取 这 个 Hashtable 对 象 ， 分 别 
用 于 不 同 的 环境 : 

public void getTable(HttpServletRequest request}{ 
request.getSession().setAttribute("books",table); 


} 
public Hashtable getTable(){ 
return this..table; 


L 

其 中 第 一 种 方法 只 是 把 这 个 对 象 存储 到 Session 对 象 中 ， 如 果 需 要 使 用 这 个 对 象 ， 还 需 
要 从 Session 对 象 中 获取 。 

3. SAXErrorHandler.java 文件 

在 上 面 的 解析 器 中 注册 了 一 个 内 容 处 理 器 和 一 个 错误 处 理 器 ,内容 处 理 器 当然 就 是 对 XML 
文件 的 内 容 进 行 处 理 ， 但 当 在 处 理 的 过 程 中 遇 到 错误 时 就 需要 错误 处 理 器 来 处 理 。 

SAX 的 错误 分 为 3 个 等 级 : error、warning 和 fatalError。 任 何 错误 处 理 器 都 要 实现 
ErrorHandler 接口 ，ErrorHandler 接口 中 提供 了 处 理 这 3 类 错误 的 方法 ， 任 何 错误 处 理 器 都 
必须 实现 这 些 方法 。 下 面 是 错误 处 理 器 SAXErrorHandler.java 的 源 代码 : 


package cn.ac.ict; 


import org.xml.sax.ErrorHandler; 

import org.xml.sax.SAXException; 

import org.xml.sax.SAXParseException; 

public class SAXErrorHandler implements ErrorHandler { 


public SAXErrorHandler() { 
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Super(); 
/TODO Auto-generated constructor stub 
} 
public void warning (SAXParseException e)throws SAXException { 
System.out.println( 
"分 析 警 告 ---\n" + 


"发 生 位 置 :\t\t 第 "+ e.getLineNumber() + " 行 , " + 
"” 第 "+ e.getColumnNumber()+" 字 \n"+ 
"系统 标识 符 :\t" + e.getSystemld() + wn'" + 
"公用 标识 符 :\t" + e.getPublicld() + "\n"+ 
” ”错误 消息 :tt" + e.getMessage() 

); 

throw new SAXException(" 遇 到 警告 .", e); 

} 


public void error (SAXParseException e)throws SAXException{ 

System.out.println( 
"一 可 恢复 的 分 析 错 误 ----\n" + 
"发生 位 置 :\t\t 第 "+ e.getLineNumber() + " 行 ," + 
"” ”第 "+ e.getColumnNumber() +" 字 \n"+ 
"系统 标识 符 :\t" + e.getSystemld() + \n"+ 
"公用 标识 符 :\t" + e.getPublicld() + \n"+ 
"” ”错误 消息 Ntt" + e.getMessage() 

); 
throw new SAXException(" 遇 到 可 恢复 错误 .", e); 


} 
Ar 
* * 接 受 不 可 恢复 的 错误 调用 
a 
public void fatalError(SAXParseException e) throws SAXException{ 
System.out.println( 
"---- 不 可 恢复 的 分 析 错 误 ----\n" + 
"” ”发生 位 置 :\t\t 第 " + e.getLineNumber() + " 行 ," + 
"” 第 "+ e.getColumnNumber() + " 字 \n" + 
"系统 标识 符 :\t" + e.getSystemld() + An'" + 
"公用 标识 符 :\t" + e.getPublicld() + "\n"+ 
” ”错误 消息 :tt" + e.getMessage() 
) 
throw new SAXException(" 遇 到 不 可 恢复 错误 .", e); 
} 
> 


4. SAXExample.jsp 文件 
把 上 面 的 文件 都 准备 好 后 ， 就 可 以 编写 使 用 这 个 解析 器 的 JSP 文件 了 ， 下 面 是 JSP 文 
件 的 内 容 : 


<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import = "java.util.*"%> 
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<%@ page import = "cn.ac.ict.*"%> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 

<head> 

<tile>SAX XML JSP</title> 

</head> 
<body bgcolor="#FFFFFF"> 
<jsp:useBean id="saxparser" scope="session" class="cn.ac.ict.SAXHandlerBean" /> 


<% 
// 解 析 文件 
Saxparser.parseXML("C:\Tomcat 5.0\webapps\N13\books.xml"); 
/把 解析 结果 存放 到 客户 的 Session 中 
saxparser.getTable(request); 
// 从 Session 中 获取 解析 结果 
Hashtable table = (Hashtable)session.getAttribute("books"); 
/循环 迭代 并 输出 解析 结果 
Enumeration enum = table.keys(); 
while(enum.hasMoreElements()){ 
String booktitle = (String)enum.nextElement(); 
BookBean book = (BookBean)table.get(booktitle); 
%> 
书 名 : <%=book.getTitle()%><br> 
URL:<%=book.getUrl()%><br> 
作者 : <%=book.getAuthor()%><br> 
出 版 日 期 <%=book.getDate()%><br> 
<br><br> 
<%}%> 


</body> 
</html> 
在 这 个 JSP 文件 中 使 用 了 解析 器 的 JavaBeans: 
<jsp:useBean id="saxparser" scope="session" class="cn.ac.ict.SAXHandlerBean" /> 
然后 指定 让 它 解析 一 个 文件 ， 并 把 解析 的 结果 存储 到 客户 的 会 话 对 象 中 ， 之 后 ， 客 户 
使 用 时 就 可 以 从 会 话 对 象 中 获取 了 : 
saxparser.parseXML("C:\Tomcat 5.0\webapps\\13\books.xml"); 


saxparser.getTable(request); 
Hashtable table = (Hashtable)session.getAttribute("books"); 


之 后 就 可 以 对 解析 的 结果 进行 操作 了 。 

把 需要 使 用 JavaBeans 编译 后 的 字 节 码 文件 复制 到 Web 应 用 的 WEB-INF\classes 目录 下 。 
各 注意 : 文件 存放 的 目录 层次 和 类 的 包 应 该 一 致 。 

把 JSP 文件 复制 到 Web 应 用 的 根 目录 下 ， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http:/ 
localhost:8080/13/SAXExample.jsp， 可 以 看 到 页 面 显 示 如 图 13.4 所 示 。 
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图 13.4 SAX 实例 
13.5 使 用 XSLT 给 XML 定制 样式 


XSLT 的 英文 标准 名 称 为 eXtensible Stylesheet Language Transformation。 根 据 W3C 的 规 
范 说 明 书 (http:/www.w3.org/TR/xslt) , 最早 设计 XSLT 的 用 意 是 帮助 XML 文档 (document) 
转换 为 其 他 文档 。 但 随 着 不 断 的 发 展 , XSLT 已 不 仅仅 用 于 将 XML 转换 为 HTML 或 其 他 文 
本 格式 ， 更 全 面 的 定义 应 该 是 ，XSLT 是 一 种 用 来 转换 XML 文档 结构 的 语言 。 

XSLT 转换 的 过 程 可 以 用 图 13.5 表示 。XSLT 处 理 器 读 取 两 个 文件 :XML 源 文件 和 XSLT 
样式 文件 ， 然 后 转换 成 HTML 或 者 其 他 的 格式 输出 。XML 源 文 件 的 作用 是 提供 数据 ， 而 
XSLT 样式 文件 则 是 规定 了 如 何 转换 和 转换 后 的 格式 。 

例如 如 下 的 XML 文件 Chello.xml) : 

<?xml version="1.0" encoding="iso-8859-1"?> 

<greeting>Hello, world!</greeting> 


使 用 浏览 器 打开 这 个 文档 ， 可 以 看 到 效果 如 图 13.6 所 示 。 
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图 13.5 XSLT 转换 的 过 程 图 13.6 ”使 用 浏览 器 查看 XML 文档 


页 面 上 只 是 传达 了 一 个 “Hello，world!” 的 信息 ， 可 屏幕 上 却 显示 了 大 量 的 无 关 字符 ， 
at 读者 可 能 会 看 出 它 是 什么 意义 ， 如 果 内 容 多 了 以 后 ， 就 会 发 现 阅读 
起 来 比较 麻烦 ， 虽 然 它 显得 已 经 很 容易 阅读 了 。 

下 面 使 用 一 个 XSLT 样式 文件 把 这 个 文件 转换 为 HTML 格式 的 文件 ， 让 它 以 更 容易 阅 
读 的 格式 显示 出 来 ， 下 面 是 这 个 XSLT 样式 文件 的 代码 : 

<?xml version="1.0" encoding="iso-8859-1"?> 
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<!-- 声明 使 用 的 命名 空间 一 > 
<xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl"> 
<!--- ”定义 一 个 模板 template ”一 > 
<xsl:template match="/"> 
<html> 
<head> 
<title>First XSLT example</title> 
</head> 
<body> 
<p><xsl:value-of select="greeting"/></p> 
</body> 
</html> 
</xsl:template> 
</xsl:stylesheet> 
在 这 个 XSLT 样式 文件 中 ， 声 明了 它 使 用 的 命名 空间 ， 并 添加 了 一 个 <xsl:template> 元 
素 ， 也 就 是 XSLT 的 模板 元 素 。XSLT 样式 文件 就 是 由 一 个 个 模板 构成 的 ，XSLT 处 理 器 会 
使 用 各 个 模板 对 XML 元 素 进 行 转换 , 然后 把 各 个 转换 的 结果 组 合 起 来 , 形成 最 终 的 新 文档 ， 


其 中 <xsl:template> 元 素 的 match 属性 说 明了 这 个 模板 可 以 被 应 用 到 的 场合 。 


全 注意 : 读者 如 果 需 要 进一步 地 了 解 XML 和 XSLT 的 转换 ， 可 以 参考 其 他 的 相关 文档 和 
书籍 ， 这 里 由 于 篇 幅 所 限 ， 不 再 过 多 介绍 。 

有 了 XML 文件 和 XSLT 样式 文件 之 后 , 如 何 使 用 它们 进行 转换 呢 ? 要 实现 XSLT 转换 
还 需要 一 个 XSLT 处 理 器 ，XSLT 处 理 器 根据 不 同 的 需要 也 是 有 很 多 的 。 在 这 里 ， 为 了 让 读 
者 能 够 看 到 XSLT 转换 的 效果 , 就 使 用 IE 中 默认 使 用 的 微软 的 一 个 XSLT 处 理 器 来 进行 转换 。 
首先 要 修改 XML 文件 ， 在 这 个 文件 中 ， 声 明 使 用 的 XSLT 样式 文件 ， 修 改 后 的 代码 如 下 : 

<?xml version="1.0" encoding="iso-8859-1"?> 

<!--- ”声明 使 用 的 XSLT 文 件 “一 > 

<?xml-stylesheet type="text/xsl" href="hello.xsl"?> 

<greeting>Hello, world!</greeting> 

微软 的 XSLT 处 理 器 MSXML 现在 的 最 高 版 本 是 4.0 SP5，MSXML 是 随 IE 浏览 器 
起 发 布 的 ， 如 果 IE 的 版 本 在 5.0 以 上 ， 就 会 有 这 个 处 理 器 ， 如 果 没 有 ， 读 者 可 以 到 微软 
的 官方 网 站 下 载 ， 下 载 地 址 是 : http://www.microsoft.com/downloads/details.aspx?FamilyID= 
4a3ad088-a893-4f0b-a932-5e024e74519f&DisplayLang=en。 


使 用 浏览 器 打开 修改 过 的 XML 文档 (XML 文档 要 和 XSLT 样式 文件 放 在 同一 个 文件 
来 下 ) ， 可 以 看 到 这 时 XML 文档 的 显示 效果 好 多 了 ， 如 图 13.7 所 示 。 


图 13.7 使 用 MSXML 转换 后 的 XML 文档 
上 面 的 小 例子 ， 只 是 在 客户 端 将 XML 文件 按照 XSLT 文件 的 要 求 显示 ,， 下面 介 绍 如 何 
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在 服务 器 端 编 程 实现 这 样 的 转换 。 


13.5.1 建立 XML 文件 


首先 需要 建立 XML 文件 ，XML 文件 的 建立 比较 简单 ， 而 且 本 章 前 面 也 有 介绍 ， 这 里 
不 作 详 细 说 明 ， 下 面 是 XML 文件 (books 2.xml) 的 内 容 : 


<?xml version="1.0" encoding="gb2312"?> 
<?xml-stylesheet type="text/xsl" href="bookhtml.xsl"?> 
<books> 
<book id="1"> 
<title url="http://java.sun.com">JSP 应 用 开发 指南 </title> 
<author>Author 001</author> 
<date> 
<day>23</day> 
<month>1</month> 
<year>2006</year> 
</date> 
<description> 一 本 详尽 介绍 JSP 技术 的 书 </description> 
</book> 


<book id="2"> 
<title url="http://ant.apache.org/">Ant 技术 详解 </title> 
<author>Author 002</author> 
<date> 
<day>23</day> 
<month>1</month> 
<year>2006</year> 
</date> 
<description> 一 本 详尽 介绍 Ant 技术 的 书 </description> 
</book> 


<book id="3"> 
<title url="http://www.apache.org">Apache 技术 详解 </title> 
<author>Author 003</author> 
<date> 
<day>23</day> 
<month>1</month> 
<year>2006</year> 
</date> 
<description> 一 本 详尽 介绍 Apache 技术 的 书 </description> 
</book> 


</books> 


13.5.2 ”建立 XSLT 文件 


下 面 是 使 用 的 XSLT 文件 ， 具 体 关 于 XSLT 文件 的 编写 方法 请 读者 参考 其 他 的 书籍 。 
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSUTransform" version="1.0"> 
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<xsl:template match="/"> 

<HTML><TITLE>Using XSLT Style XML</TITLE><BODY> 
<xsl:apply-templates/> 

</BODY></HTML> 

</xsl:template> 


<!--” 列 出 所 有 的 books --> 

<xsl:template match="books"> 

<TABLE border="1"> 

<TR><TD>Book Title</TD><TD>Author</TD><TD>Publish Date</TD><TD>Description</TD> 
</TR> 

<xsl:apply-templates/> 

</TABLE> 

</xsl:template> 


<!--” 列 出 一 个 book 的 信息 --> 

<xsl:template match="book"> 

<TR><TD><xsl:apply-templates select="title"/></TD><TD><xsl:value-of select="author"/></TD> 
<TD><xsl:apply-templates select="date"/></TD><TD><xsl:value-of select="description"/></TD> 
</TR> 

</xsl:template> 


<!--” 列 出 一 个 book 的 title 的 链接 和 文字 信息 --> 
<xsl:template match="title"> 
<A href="{@url}"><xsl:value-of select="."/></A> 
</xsl:template> 


<!--” 列 出 一 个 book 的 出 版 日 期 信息 --> 
<xsl:template match="date"> 
<xsl:value-of select="year"/>-<xsl:value-of select="month"/>-<xsl:value-of select="day"/> 
</xsl:template> 


</xsl:stylesheet> 


13.5.3 ”建立 源 数据 的 对 象 


源 数据 的 对 象 表示 XML 数据 , 这 些 数据 用 于 创建 最 后 的 输出 , 把 XML 源 数据 和 XSLT 
结合 起 来 是 使 用 JAXP 完成 的 。 

1. StreamSource 

使 用 一 个 XML 文件 对 象 作为 源 数据 时 的 代码 如 下 : 

StreamSource ss = new StreamSource(new File("Your_xml_file.xml")); 

如 果 只 是 提供 XML 文件 的 名 字 ， 也 可 以 使 用 字符 串 构建 源 数据 的 对 象 ， 代 码 如 下 : 


StreamSource ss = new StreamSource(new StringReader(new String())); 
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2. DOMSource 
DOMSource 表示 DOM 格式 的 源 数据 ， 建 立 DOM 源 数据 对 象 的 代码 如 下 : 


DocumentBuilderFactory dbf = DocumentBuilderFactory.newlnstance(); 
DocumentBuilder db = dbf.newDocumentBuilder(); 

Document d = db.parse("Your_xml_file.xml”); 

DOMSource ds = new DOMSource(d); 


3. SAXSource 
SAXSource 表示 SAX 格式 的 源 数据 ， 建 立 SAX 源 数据 对 象 的 代码 如 下 : 


SAXSource ss = new SAXSource(new InputSource(new FileReader("Your_ xml file.xml"))); 
13.5.4 ”建立 结果 数据 的 对 象 


结果 数据 的 对 象 是 JAXP 转换 的 输出 结果 ， 结 果 不 一 定 是 XML 格式 的 ， 在 JAXP 中 ， 
有 3 个 实现 Result 接口 的 对 象 ， StreamResult、DOMResult 和 SAXResult。 

1. StreamResult 

StreamResult 是 流 的 转换 结果 ， 在 把 结果 写 到 文件 或 者 JSP 输出 流 时 使 用 StreamResult 
比较 多 。 下 面 是 把 结果 输出 到 一 个 文件 的 例子 : 

StreamResult sr = new StreamResult(new File("example.out )); 

当 把 结果 输出 到 JSP 的 输出 流 中 ， 代 码 如 下 : 

StreamResult sr = new StreamResult(out); 

2. DOMResult 

DOMResult 保存 DOM 树 型 对 象 的 转换 结果 ,这 个 对 象 可 以 继续 使 用 Document 对 象 进 
行 操 作 ， 当 在 应 用 之 间 传 递 Document 对 象 时 比较 有 用 ， 此 时 的 代码 如 下 : 


DocumentBuilderFactory dbf = DocumentBuilderFactory.newlnstance(); 
DocumentBuilder db = dbf.newDocumentBuilder(); 

Document d = db.newDocument(); 

DOMResult dr = new DOMResult(d); 


3. SAXResult 

SAXResult 是 实现 ContentHandler 接口 的 对 象 处 理 SAX 事件 的 结果 ， 下 面 是 一 段 简 单 
的 代码 : 

SAXResult sr = new SAXResult(new DefaultHandler()); 


13.5.5 ”转换 数据 


通过 上 面 几 步 的 介绍 ， 读 者 对 建立 一 个 简单 的 JAXP 转换 的 过 程 应 该 有 足够 的 了 解 了 ， 
要 进行 转换 ， 使 用 TransformerFactory 生成 一 个 转换 器 是 必 不 可 少 的 ,在 本 例 中 使 用 Stream 
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Source 表示 XSLT 文件， 下 面 是 JSP 文件 〈transform.jsp) 的 代码 : 


<%@ page language="java" pageEncoding="GB2312" %> 

<%@ page import="javax.xml.parsers.*,org.w3c.dom.*,javax.xml.transform.*， 
javax.xml.transform.stream.*,java.io.*"%> 

<% 

/XML 文件 

StreamSource xml = new StreamSource(new File("c:/xmllinks.xml”)); 
/XSLT 文件 

StreamSource xsl = new StreamSource(new File("c:/xmllinks_html.xsl”)); 
// 转 换 器 工厂 

TransformerFactory tFactory = TransformerFactory.newlnstance(); 

// 获 取 一 个 转换 器 

Transformer transformer = tFactory.newTransformer(xs)); 

// 得 到 结果 ， 并 输出 到 JSP 页 面 

StreamResult result = new StreamResult(out); 

// 执 行 转换 

transformer.transform(xml, result); 

%> 


在 输出 结果 时 ， 使 用 了 JSP 的 隐 含 对象， 将 结果 输出 到 JSP 页 面 。 
// 得 到 结果 ， 并 输出 到 JSP 页 面 


StreamResult result = new StreamResult(out); 
把 这 个 JSP 文件 发 布 到 本 章 的 Web 应 用 中 ， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : 
http://localhost:8080/13/transform.jsp， 可 以 看 到 页 面 显 示 如 图 13.8 所 示 。 
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图 13.8 使 用 XSLT 文件 格式 化 XML 文件 


13:6 小 结 


在 本 章 中 介绍 了 很 多 关于 在 JSP 中 使 用 XML 文件 的 技术 ， 随 着 XML 的 流行 ，JSP 和 
XML 技术 的 结合 将 更 加 紧密 ， 事 实 上 ， 现 在 完全 可 以 按照 XML 的 格式 书写 JSP 文件 ， 读 
者 如 果 感 兴趣 ， 可 以 参考 相关 书籍 。 
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Servlet API 很 早 就 已 成 为 企业 应 用 开发 的 重要 工具 , 而 Servlet 2.3 版 中 新 增 的 过 滤器 和 
监听 器 功能 则 是 对 J2EE 体系 的 一 个 补充 ,过 滤器 使 得 Servlet 开发 者 能 够 在 请 求 到 达 Servlet 
之 前 截取 请 求 ， 在 Servlet 处 理 请 求 之 后 修改 应 答 ; 而 Servlet 监听 器 可 以 监听 客户 端的 请 
求 、 服 务 端 的 操作 ， 通 过 监听 器 ， 可 以 自动 激发 一 些 操 作 ， 如 监听 应 用 的 启动 和 停止 。 本 
章 将 介绍 Servlet 过 滤器 和 监听 器 的 相关 知识 以 及 在 实际 开发 中 如 何 使 用 这 些 技术 。 


14.1 Servlet 过 滤器 简介 


Servlet 过 滤器 是 小 型 的 Web 组 件 ， 它 能 拦截 请 求 和 响应 ， 以 便 查看 、 提 取 或 以 某 种 方 
式 操作 正在 客户 机 和 服务 器 之 间 交 换 的 数据 。 过 滤器 通常 封装 了 一 些 功 能 的 Web 组 件 ， 这 
些 功能 虽然 很 重要 ， 但 对 于 处 理 客户 机 请 求 或 发 送 响 应 来 说 不 是 决定 性 的 。 典 型 的 例子 包 
括 记录 关于 请 求 和 响应 的 数据 、 处 理 安全 协议 、 管 理会 话 属性 等 。 

Servlet 过 滤器 介 于 与 之 相关 的 Servlet 或 JSP 页 面 和 客户 之 间 ， 某 个 资源 一 旦 与 某 个 
Servlet 过 滤器 相关 联 ， 则 对 这 个 资源 的 任何 请 求 或 这 个 资源 的 响应 都 要 经 过 与 之 关联 的 
Servlet 过 滤器 再 调用 或 返回 。 


及 注意 过 滤器 只 能 在 与 Servlet 规范 2.3 版 ( 含 以 上 ) 兼容 的 服务 器 上 运行 。 如 果 Web 
应 用 必须 使 用 旧版 服务 器 ， 就 不 能 使 用 过 滤器 。 

Servlet 过 滤器 接受 请 求 并 响应 对 象 ， 然 后 过 滤器 会 检查 请 求 对 象 ， 决 定 将 该 请 求 转发 
给 链 中 的 下 一 个 组 件 ， 或 者 中 止 该 请 求 并 直接 向 客户 机 发 回 一 个 响应 。 如 果 请 求 被 转发 了 ， 
它 将 被 传递 给 链 中 的 下 一 个 资源 〈 另 一 个 过 滤器 、Servlet 或 JSP 页 面 ) 。 在 这 个 请 求 通过 
过 滤器 链 并 被 服务 器 处 理 之 后 ， 一 个 响应 将 以 相反 的 顺序 通过 该 链 发 送 回 去 。 这 样 就 给 每 
个 过 滤器 都 提供 了 根据 需要 处 理 响 应 对 象 的 机 会 。 

一 个 过 滤器 可 以 被 关联 到 任意 多 个 资源 ， 一 个 资源 也 可 以 关联 到 任意 多 个 过 滤器 。 例 
如 在 图 14.1 中 有 如 下 的 关联 关系 。 

口 Fl 同时 被 关联 到 S1、S2、S3。 

口 FI、F2、F3 都 和 S2 关联 。 

关联 到 同一 个 资源 的 过 滤器 形成 一 个 过 滤器 链 。 例 如 对 S2 访问 时 ，F1、F2、F3 就 形 
成 了 一 个 过 滤器 链 ， 客 户 要 访问 资源 S2， 就 要 经 过 Fl 过 滤器 ， 然 后 是 F2、F3， 最 后 才 是 
要 访问 的 资源 ， 如 果 在 经 过 上 面 这 3 个 过 滤器 时 出 现 了 错误 或 者 被 禁止 访问 ， 客 户 的 请 求 
就 无 法 到 达 资 源 S2, 在 Servlet 过 滤器 中 , 这 个 过 滤器 传递 的 过 程 是 通过 FilterChain.dofilter() 
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方法 实现 的 ， 当 过 滤器 链 到 达 末 尾 时 ， 这 个 方法 调用 请 求 的 资源 。 建 立 一 个 过 滤器 涉及 下 
列 4 个 步骤 。 

(1) 建立 一 个 实现 Filter 接口 的 类 。 这 个 
类 需要 3 个 方法 , 分 别 是 : doFilter、init 和 destroy。 
doFilter 方法 包含 主要 的 过 滤 代 码 ( 见 第 (2) 步 )， 
在 init 方 法 中 进行 一 些 初始 化 的 设置 , 而 destroy 
方法 进行 清除 过 滤器 占用 的 资源 。 

(2) 在 doFilter 方法 中 放 入 过 滤 行 为 。 
doFilter 方法 的 第 一 个 参数 为 ServletRequest 对 
象 。 此 对 象 给 过 滤器 提供 了 对 进入 的 信息 〈 包 
括 表 单数 据 、Cookie 和 HTTP 请 求 头 ) 的 完全 图 14.1 ”Web 资源 与 过 滤器 相关 联 
访问 。 第 二 个 参数 为 ServletResponse， 通 常 在 
简单 的 过 滤器 中 忽略 此 参数 。 最 后 一 个 参数 为 FilterChain， 如 下 一 步 所 述 ， 此 参数 用 来 调用 
过 滤器 链 中 下 一 个 过 滤器 或 者 在 到 达 过 滤器 末尾 时 调用 Servlet 或 JSP 页 。 

(3) 调用 FilterChain 对 象 的 doFilter 方法 。Filter 接口 的 doFilter 方法 把 一 个 FilterChain 
对 象 作为 它 的 一 个 参数 。 在 调用 此 对 象 的 doFilter 方法 时 ， 激 活 下 一 个 相关 的 过 滤器 。 如 果 
没有 另 一 个 过 滤器 与 Servlet 或 JSP 页 面 关联 ， 则 Servlet 或 JSP 页面 被 激活 。 

(4) 对 相应 的 Servlet 和 JSP 页 面 注册 过 滤器 。 在 部 署 描 述 符 文件 《web.xml) 中 使 用 
filter 和 filter-mapping 元 素 对 需要 进行 过 滤 的 资源 进行 配置 。 


14.2 ”实现 一 个 Servlet 过 滤器 


Servlet 过 滤器 API 包含 3 个 简单 的 接口 ,它们 在 javax.servlet 包 中 。 这 3 个 接口 分 别 是 
Filter、FilterChain 和 FilterConfig。 从 编程 的 角度 看 ， 过 滤器 类 将 实现 Filter 接口 ， 然 后 使 用 
这 个 过 滤器 类 中 的 FilterChain 和 FilterConfig 接口 。 该 过 滤器 类 的 一 个 引用 将 传递 给 
FilterChain 对 象 ， 以 允许 过 滤器 把 控制 权 传递 给 过 滤器 链 中 的 下 一 个 过 滤器 或 者 资源 。 
FilterConfig 对 象 将 由 容器 提供 给 过 滤器 ， 以 允许 访问 该 过 滤器 的 初始 化 数据 。 


14.2.1 编写 实现 类 的 程序 


下 面 介绍 一 个 简单 的 Servlet 过 滤器 的 例子 ,在 这 个 例子 中 ， 获 取 一 个 Web 服务 器 给 客 
户 提 供 服务 需要 的 时 间 ， 也 就 是 响应 时 间 。 


package cn.ac.ict.Filter; 


import java.io.IOException; 
import java.io.PrintWriter; 
import java.io.StringWriter; 
import java.util.Date; 
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import javax.servlet.*; 


public class ResponseTimeFilter implements Filter { 
private FilterConfig filterConfig = null; 
// 初 始 化 函数 
public void init(FilterConfig config) throws ServletException { 
this.fiterConfig = config; 
} 


public void doF ilter(ServletRequest request, ServletResponse response, 
FilterChain chain) throws IOException, ServletException { 

Date startTime, endTime; 
double totalTime; 
startTime = new Date(); 

StringWriter sw = new StringWriter(); 

PrintWriter writer = new PrintWriter(sw); 

writer.println(); 

writer.printiIn("ResponseTimeFilter Before call chain.doFilter ); 


/ 把 请 求 转发 给 过 滤器 链 中 下 一 个 资源 
chain.doFilter(request, response); 

/下 面 是 资源 的 响应 时 间 

/下 面 计算 开始 时 间 和 结束 时 间 的 差 ， 也 就 是 响应 时 间 
endTime = new Date(); 

totalTime = endTime.getTime() - startTime.getTime(); 
/将 毫秒 时 间 转 换 为 以 秒 为 单位 

totalTime = totalTime / 1000; 


writer.printIn("ResponseTimeFilter BR call chain.doFilter"); 
writer.printIn("==============="); 

writer.println("Total elapsed time is: 
writer.printIn("==============="); 

// 把 信息 输出 到 日 志 
fiterConfig.getServletContext().log(sw.getBuffer().toString()); 
writer.flush(); 


+ totalTime + " seconds." ); 


} 


public void destroy() { 
this.filterConfig = null; 
} 


public FilterConfig getFilterConfig() { 
return null; 


} 


public void setFilterConfig(FilterConfig config) { 
b 
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当 容 器 第 一 次 加 载 该 过 滤器 时 ，init0 方 法 将 被 调用 。 该 类 在 这 个 方法 中 包含 了 一 个 指 
向 FilterConfig 对 象 的 引用 。 

过 滤器 的 大 多 数 时 间 都 消耗 在 执行 过 滤 操作 上 ，doFilter() 方 法 被 容器 调用 , 同时 传 入 分 
别 指向 这 个 请 求 /响应 链 中 的 ServletRequest、ServletResponse 和 FilterChain 对 象 的 引用 。 然 
后 过 滤器 就 有 机 会 处 理 请 求 ， 将 处 理 任务 传递 给 链 中 的 下 一 个 资源 〈 通 过 调用 FilterChain 
对 象 引 用 上 的 doFilter() 方 法 ) ， 之 后 在 处 理 控制 权 返 回 该 过 滤器 时 处 理 响应 。 

在 本 实例 中 ， 过 滤器 接受 到 客户 的 请 求 后 ， 记 录 当 前 的 系统 时 间 ， 然 后 把 请 求 转发 给 过 
滤器 链 中 其 他 资源 ， 在 得 到 响应 后 ， 再 记录 得 到 响应 的 时 间 ， 这 个 差 值 也 就 是 响应 时 间 了 : 

startTime = new Date(); 
StringWriter sw = new StringWriter(); 
PrintWriter writer = new PrintWriter(sw); 


writer.println(); 
writer.println("ResponseTimeFilter Before call chain.doFilter"); 


// 把 请 求 转发 给 过 滤器 链 中 下 一 个 资源 
chain.doFilter(request, response); 

/下 面 是 资源 的 响应 时 间 

/一 -一 -一 一 

/下 面 计算 开始 时 间 和 结束 时 间 的 差 ， 也 就 是 响应 时 间 
endTime = new Date(); 

totalTime = endTime.getTime() - startTime.getTime(); 
// 将 毫秒 时 间 转 换 为 以 秒 为 单位 

totalTime = totalTime / 1000; 


最 后 把 构造 相关 的 信息 输出 到 日 志 中 : 


writer.printIn("ResponseTimeFilter Before call chain.doFilter"); 


writer.printIn("==============="); 

writer.println("Total elapsed time is: " + totalTime + " seconds." ); 
writer.printIn("==============="); 

// 把 信息 输出 到 日 志 中 
fiterConfig.getServletContext().log(sw.getBuffer().toString()); 
writer.flush(); 


14.2.2 配置 发 布 Servlet 过 滤器 


发 布 Servlet 过 滤器 时 ， 必 须 在 web.xml 文件 中 加 入 <filter> 和 <filter-mapping> 元 素 ， 
<filter> 元 素 用 来 定义 一 个 过 滤器 ， 如 本 例 中 使 用 如 下 代码 : 
<filter> 
<filter-name>Request Response Time</filter-name> 
<filter-class>cn.ac.ict.Filter.ResponseTimeFilter</filter-class> 
</filter> 
以 上 代码 中 <filter-name> 指 定 过 滤器 的 名 字 , <filter-class> 指 定 过 滤器 的 完整 类 名 , 也 可 
以 在 <filter> 元 素 中 内 嵌 <init-param> 元 素来 为 过 滤器 提供 初始 化 参数 ; <filter-mapping> 元 素 
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用 于 将 过 滤器 和 URL 关联 ， 本 例 中 的 代码 如 下 : 
<filter-mapping> 
<filter-name>Request Response Time</filter-name> 
<url-pattern>/ShowCounter.jsp</url-pattern> 
</filter-mapping> 
当 客 户 请 求 的 URL 和 <url-pattem> 指 定 的 URL 相 匹 配 时 , 就 会 触发 ResponseTimeFilter 
过 滤器 ， 这 里 的 <filter-name> 元 素 的 值 和 <filter> 元 素 中 的 <filter-name> 值 应 该 是 相同 的 。 


全 注意 : 如 果 希 望 Servlet 过 滤器 能 过 滤 所 有 的 客户 请 求 , 可 以 把 <url-pattern> 的 值 设置 为 /#。 
准备 好 上 面 的 文件 后 ， 读 者 可 以 按照 如 下 步骤 发 布 这 个 Servlet 过 滤器 : 

(1) 编译 ResponseTimeFilter 这 个 类 ， 编 译 时 ， 需 要 把 Java Servlet API 的 包 servlet- 
apijar 放 到 类 路 径 中 , 编译 后 的 类 放 到 本 章 Web 应 用 的 WEB-INF\classes 目录 下 , 并 且 目 录 
结构 要 和 包 的 结构 一 致 。 

(2) 在 web.xml 文件 中 按照 上 面 说 明 的 方法 配置 这 个 过 滤器 。 

(3) 为 了 观察 这 个 过 滤器 的 日 志 ， 应 该 确保 在 server.xml 文件 的 localhost 对 应 的 host 
元 素 中 配置 了 如 下 的 logger 元 素 : 

<Logger className="org.apache.catalina.logger.FileLogger" 
directory="logs" prefix="localhost_log.” suffix=".txt" 
timestamp="true"/> 
默认 情况 下 是 配置 好 的 。 

(4) 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/14/Show 
Counter,jsp， 这 时 ,在 <TOMCAT_HOME>\logs\localhost log.2006-02-12.txt 文件 中 会 生成 如 
下 的 日 志 信息 : 

2006-02-12 23:03:42 StandardContext[/14] 


ResponseTimeFilter Before call chain.doFilter 
ResponseTimeFilter Before call chain.doFilter 


全 注意 : 本 例 中 访问 的 ShowCounter.jsp 页 面 将 在 本 章 的 监听 器 部 分 介绍 ， 如 果 读 者 不 想 
跳跃 着 查看 这 个 文件 ， 可 以 尝试 修改 过 滤器 关联 的 URL， 使 得 它 可 以 过 滤 读 者 指 


14.3 ServletRequest 和 ServletResponse 的 包装 类 


Servlet 过 滤器 能 够 对 客户 的 请 求 和 响应 进行 包装 ， 并 根据 自 定义 的 行为 对 请 求 和 响应 
进行 修改 , 这 就 是 通过 使 用 ServletRequest 和 ServletResponse 的 包装 类 一 一 HttpServletRequest 
Wrapper 和 HttpServletResponseWrapper 类 来 实现 的 , 这 两 个 类 提供 了 所 有 request 和 response 
方法 的 默认 实现 ， 并 且 默 认 代 理 了 所 有 对 原 有 request 和 response 的 调用 。 这 意味 着 要 改变 
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一 个 方法 的 行为 上 只 需 要 从 封装 类 继承 并 重新 实现 一 个 方法 即 可 。 
口 ServletRequestWrapper 类 是 ServletRequest 的 包装 类 , 它 实现 了 ServletRequest 接口 ， 
并 对 其 方法 提供 了 默认 实现 。 
口 ServletResponseWrapper 类 是 ServletResponse 的 包装 类 ， 它 实现 了 ServletResponse 
接口 ， 并 对 其 方法 提供 了 默认 实现 。 


14.4 用 Servlet 过 滤器 过 滤 文 本 信息 


在 14.3 节 中 简单 介绍 了 ServletRequest 和 ServletResponse 的 包装 类 ， 它 们 在 过 滤器 设 
计 中 还 是 会 经 常用 到 的 ， 在 本 节 中 介绍 一 个 使 用 HttpServletResponseWrapper 类 的 例子 ， 客 
户 输入 的 内 容 会 被 检查 ， 如 果 有 不 允许 出 现 的 信息 时 ， 就 会 被 过 滤 掉 ， 而 被 奉 换 成 其 他 的 
字符 。 

在 这 个 例子 中 ， 客 户 输入 用 户 名 并 发 布 自己 的 留言 信息 ， 然 后 提交 给 服务 器 ， 服 务 器 
再 把 这 些 信 息 反馈 给 客户 ， 如 果 客 户 的 留言 中 有 指定 的 字符 串 就 会 调用 过 滤器 将 这 个 字符 
串 蔡 换 掉 。 


14.4.1 输出 流 管理 类 


在 Servlet 输出 时 可 以 选择 不 同 的 输出 流 ， 将 它们 集合 在 一 起 ， 就 可 以 很 容易 地 对 这 些 
流 进行 管理 ， 使 用 时 也 会 更 方便 ， 下 面 是 这 个 管理 类 的 代码 (ByteArrayPrintWriter.java): 


package cn.ac.ict.Filter; 

import java.io.ByteArrayOutputStream; 
import java.io. PrintW /riter; 

import javax.servlet.ServletOutputStream; 


public class ByteArrayPrintWriter { 
private ByteArrayOutputStream baos = new ByteArrayOutputStream(); 
private PrintWriter pw = new PrintWriter(baos); 
private ServletOutputStream sos = new ByteArrayServletStream(baos); 


public ByteArrayPrintWriter(ByteArrayOutputStream aos){ 
this.baos = aos; 


} 
// 一 个 为 空 的 构造 方法 
public ByteArrayPrintWriter() { 
} 
// 使 用 字符 输出 流 时 调用 获取 输出 流 


public PrintWriter getWriter() { 
return pw; 


b 
// 使 用 字 节 输出 流 时 调用 获取 输出 流 
public ServletOutputStream getStream() { 
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return sos; 
bytel] toByteArray() { 
return baos.toByteArray(); 
了 
} 


在 这 个 类 中 定义 了 3 个 对 象 ， 一 个 是 使 用 字符 流 输出 的 ， 两 个 是 用 字 节 流 输出 的 ， 但 
是 它们 都 最 终 套 接 到 类 型 为 ByteArrayOutputStream 的 对 象 上 ， 这 个 对 象 为 它们 提供 原始 输 
出 数据 。 


14.4.2 ”编写 响应 包装 类 


这 个 例子 中 需要 把 服务 器 的 响应 进行 检查 ， 必 要 时 可 能 会 修改 其 内 容 ， 这 时 就 需要 使 
用 响应 包装 类 ， 把 响应 先 拦截 下 来 处 理 后 再 返回 给 客户 ， 下 面 是 响应 包装 类 的 代码 : 


package cn.ac.ict.Filter; 


import java.io.IOException; 

import java.io.PrintW /riter; 

import javax.serviet.ServletOutputStream; 

import javax.servlet.http. HttpServletResponse; 

import javax.servlet.http.HttpServletResponseWrapper' 


public class TextModifierResponseWrapper extends HttpServletResponseWrapper { 
private HttpServletResponse resp; 
private ByteArrayPrintWriter bapw; 
public TextModifierResponseWrapper(HttpServletResponse response,ByteArrayPrintWriter 
pw0) throws IOException { 
super((HttpServletResponse) response); 
this.resp = response; 
this.bapw = pw0; 
} 


public PrintWriter getW/riter() { 
return bapw.getW riter(); 
1 
public ServletOutputStream getOutputStream() { 
return bapw.getStream(); 


} 


public void setContentType(String type) { 
if (type.equals("text/xmI")) { 
resp.setContentType("text/html"); 
}else{ 
resp.setContentType(type); 
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关于 响应 包装 类 前 面 也 有 介绍 ， 值 得 注意 的 一 点 就 是 需要 重 写 在 响应 类 可 能 调用 的 方 
法 ， 例 如 ， 响 应 〈HttpServletResponse 的 对 象 ) 既 有 可 能 调用 getWriter 来 使 用 字符 输出 流 
输出 数据 ， 也 有 可 能 调用 getOutputStream 方法 来 使 用 字 节 输出 流 输出 数据 ， 因 此 这 两 种 方 
法 是 很 有 必要 的 ， 另 外 ,在 本 例 中 还 设置 了 响应 的 类 型 ， 因 此 重 写 setContentType 方法 也 是 
很 有 必要 的 。 


14.4.3 ”编写 Servlet 过 滤器 


前 面 编写 了 需要 使 用 的 辅助 类 ， 下 面 就 可 以 开发 进行 实际 过 滤 功 能 的 文本 过 滤器 了 ， 
其 代码 (TextModifierFilterjava) 如 下 : 
package cn.ac.ict.Filter; 


import java.io.IOException; 
import javax.servlet.Filter; 
import javax.servlet.FilterChain; 
import javax.servlet.FilterConfig; 
import javax.servlet.ServletException; 
import javax.servlet.ServletRequest' 
import javax.servlet.ServletResponse; 
import javax.servlet.http.HttpServletRequest'; 
import javax.servlet.http.HttpServletResponse; 
public class TextModifierFilter implements Filter { 
private FilterConfig filterConfig; 
private String searchStr; 
private String replaceStr; 
public void init(FilterConfig config) throws ServletException { 
this.fiterConfig = config; 
// 初 始 化 要 查找 的 字符 串 和 替换 后 的 字符 串 的 值 
this.searchStr = "search"; 
this.replaceStr = "replace"; 


} 
public void doF ilter(ServletRequest request, ServletResponse response, 
FilterChain chain) throws IOException, ServletException { 
HttpServletRequest hsr = (HttpServletRequest)request; 
final HttpServletResponse resp = (HttpServletResponse)response; 
final ByteArrayPrintWriter pw = new ByteArrayPrintWriter(); 
/构造 响应 包装 类 
TextModifierResponseWrappertmrw = new TextModifierResponseWrapper(resp,pw); 
filterConfig.getServletContext().log("TextModifierF ilter:Before call chain.doFilter ); 
// 将 请 求 转发 给 Servlet， 并 获取 响应 
chain.doFilter(request,tmrw); 
/下 面 的 代码 检查 响应 并 对 需要 替换 的 字符 进行 替换 
/将 响应 转化 为 byte 数组 
bytel] bytes = pw.toByteArray(); 
if (bytes == null || (bytes.length == 0)) { 
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filterConfig.getServletContext().log("No content!"); 


> 
// 将 其 转换 为 字符 串 便于 查找 
String content = new String(bytes); 
String searchcontent = (new String(bytes)).toLowerCase(); 
// 查 找 指定 字符 出 现 的 第 一 个 位 置 
int endPos = searchcontent.indexOf(this.searchStr); 
String returnStr; 
// 响 应 中 包含 这 样 一 个 字符 串 
if(lendPosl!=-1){ 
String front_part_Str = content.substring(0,endPos); 
returnStr = front_part_Str + "<font color=red>"+this.replaceStr+"</font>" +content. 
substring(endPos + this.searchStr.length()); 
}else{ 
// 响 应 中 不 包含 这 样 一 个 字符 串 
returnStr = content; 
; 
resp.setContentLength(returnStr.length()); 
resp.getOutputStream().write(returnStr.getBytes()); 
filterConfig.getServletContext().log("TextModifierF ilter:After call chain.doFilter ); 


b 

public void destroy() { 
this.filterConfig = null; 

} 


public FilterConfig getFilterConfig() { 
return null; 


} 


public void setFilterConfig(FilterConfig config) { 
b 
} 


上 述 代 码 的 主要 功能 集中 在 doFilter 方法 中 ， 在 这 个 方法 中 构造 了 一 个 响应 包装 器 ， 当 
调用 chain.doFilter(request,tmrw); 方 法 时 ，Servlet 的 响应 都 已 经 在 响应 包装 器 对 象 tmrw 中 
了 ， 之 后 就 可 以 调用 相关 的 方法 获取 响应 的 内 容 ， 并 进行 适当 的 处 理 了 。 
/将 响应 转化 为 byte 数组 
bytel] bytes = pw.toByteArray(); 


if (bytes == null || (bytes.length == 0)){ 
filterConfig.getServletContext().log("No content!"); 


} 
// 将 其 转换 为 字符 串 便于 查找 
String content = new String(bytes); 
String searchcontent = (new String(bytes)).toLowerCase(); 
// 查 找 指定 字符 出 现 的 第 一 个 位 置 


int endPos = searchcontent.indexOf(this.searchStr); 


String returnStr; 


第 14 章 ”使 用 Servlet 过 滤器 和 监听 器 。273 。 


// 响 应 中 包含 这 样 一 个 字符 串 
if(endPos!=-1X{ 
String front_part Str = content.substring(0,endPos); 
returnStr = front part Str + "<font color=red>"+this.replaceStr+"</font>" +content. 
substring(endPos + this.searchStr.length()); 
jelsef 
// 响 应 中 不 包含 这 样 一 个 字符 串 
returnStr = content; 
b 
resp.setContentLength(returnStr.length()); 
resp.getOutputStream().write(returnStr.getBytes()); 


14.4.4 ”编写 JSP 和 Servlet 文件 


在 前 面 的 介绍 中 ， 已 经 开发 完成 了 一 个 完整 的 文本 过 滤器 的 程序 ， 在 本 节 中 开发 演示 
过 滤器 工作 过 程 的 JSP 和 Servlet 文件 。JSP 文件 代码 如 下 : 


<%@ page language="java" pageEncoding="GB2312" %> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 
<head> 
<title>User Message</title> 
<style type="text/css"> 
el 
.unnamed1{ 
border: 2px solid; 
} 
-> 
</style> 
</head> 
<body bgcolor="#FFFFFF"> 
<form method="get" action ="textModifier"> 
<table width="580" border="0" align="center"> 
<thead align="center"><font style="font-size:24px; color:#FF0000;">User Message</font></thead> 
<tr><td colspan="2"></td></tr> 
<tr> 
<td class="unnamed1">UserName</td> 
<td class="unnamed1"><input type=text name = username></input></td> 
</tr> 
<tr> 
<td class="unnamed1">Message:</td> 
<td class="unnamed1"><textarea name="content" cols="40" rows="5"></textarea></td> 
</tr> 
<tr> 
<td class="unnamed1" align="center"><input type = submit value="submit"></input></td> 
<td class="unnamed1" align="center"><input type="reset" value="reset"></td> 
</tr> 
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</table> 
</form> 


</body> 
</html> 


在 这 个 JSP 页 面 中 提供 用 户 输入 信息 的 界面 ， 界 面 的 效果 如 图 14.2 所 示 。 
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图 14.2 用 户 输入 界面 
下 面 是 用 户 提交 输入 留言 信息 的 响应 Servlet， 其 代码 如 下 : 


package cn.ac.ict.Servlet; 

import java.io.IOException; 

import javax.servlet.ServletException; 

import javax.servlet.ServletOutputStream; 
import javax.servlet.http.HttpServlet'; 

import javax.servlet.http.HttpServletRequest'; 
import javax.servlet.http.HttpServletResponse; 


public class TextModiferServlet extends HttpServlet { 
protected void doGet(HttpServletRequest request，HttpServletResponse response) throws 
ServletException, IOException { 
/设置 响应 的 类 型 
response.setContentType("text/html;charset=gb2312"); 
ServletOutputStream out = response.getOutputStream(); 
// 获 取 请 求 参 数 
String user = request.getParameter("username"); 
String content = request.getParameter("content"); 
String outstr = " "; 
if(userl=null{ 
User = new String(user.getBytes("|SO8859-1"),"GB2312"); 
b 
if(content!=nuID){ 
content = new String(content.getBytes("|SO8859-1"),"GB2312"); 
} 
if((user!=null)&& (content!=null)){ 
outstr="User["+user+"] say: ' "+content+" ' "; 
: 
out.printin(\An"); 
out.printin("<IDOCTYPE HTML PUBLIC \"-//w3c//dtd html 4.0 transitional//en\">\A\n"); 
out.printin("<html>\r\n"); 
out.printin("<head>\An"); 
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out.printin("<title>User Message</title>\An"); 

out.printin("<style type=\"text/css\">\An"); 

out.printin("<!--\An"); 

out.printin(".unnamed1 MAMn"); 

out.printin("\tborder: 2px solid;\r\n"); 

out.println( "mn ); 

out.printin("-->\An"); 

out.printin("</style>\r\n"); 

out.printin("</head>\An"); 

out.println("<body bgcolor=\"#FFFFFF\>\An"); 

out.println("<form method=\"get\" action =\"textModifier\">\An"); 

out.println("<table width=\"580\" border=\"0\" align=\"center\">\Nn"); 

out.println("<thead align=\"center\"><font style=\"font-size:24px; color:#FF0000;\"> 
User Message</font></thead>\r\n"); 

out.println("<tr><td colspan=\"2\">"+outstr+"</td></tr>\Nn"); 

out.printin(" <tr>\A\n"); 

out.println(" <td class=\'unnamed1\">UserName</td>\An"); 

out.printiIn(” <td class=\"unnamed1\"><input type=text name = username></input> 
</td>\n\n"); 

out.println(" </tr>\r\n"); 

out.printin(" <tr>\A\n"); 

out.printin(" <td class=\"unnamed1\">Message:</td>\MAn"); 

out.printin(" <td class=\"unnamed1\"><textarea name=\"content\" cols=\"40\" rows =\"5 
\"></textarea></td>\n\n"); 

out.println(" </tr>\r\n"); 

out.printin(" <tr>\rA\n"); 

out.printin(" <td class=\"unnamed1\" align=\"center\"><input type=submit value= \"submit\"> 
</input></td>\An"); 

out.printin(" <td class=\"unnamed1\" align=\"center\"><input type=\"reset\" value=\"reset\"> 
</td>\r\n"); 

out.println(” </tr>\r\n"); 

out.printin("</table>\A\n"); 

out.printin(\An"); 

out.printiIn(\An"); 

out.printin(\An"); 

out.printin(\An"); 

out.printin("</form>\A\n"); 

out.printiIn(\An"); 

out.printiIn(\A\n"); 

out.printin("</body>\r\n"); 

out.printin("</html>"); 


} 


protected void doPost(HttpServletRequest request, 
HttpServletResponse response) throws ServletException, IOException { 
doGet(request, response); 


} 
在 这 个 Servlet 中 ， 根 据 用 户 的 留言 信息 构造 一 个 消息 再 反馈 给 用 户 ， 而 且 保 留 了 用 户 
输入 的 各 个 组 件 。 
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14.4.5 ”发 布 运 行 Web 应 用 


在 把 所 有 需要 使 用 的 文件 都 准备 好 后 ， 读 者 可 以 按照 如 下 步骤 发 布 这 个 Web 应 用 : 
(1) 编译 输出 流 管理 类 、 响 应 包装 器 和 过 滤器 的 Java 程序 ， 编 译 时 需要 把 servletrapijar 
放 到 类 路 径 中 。 编 译 完成 后 ， 把 得 到 的 字 节 码 文件 复制 到 Web 应 用 的 WEB-INF\classes 目 
录 下 ， 存 放 位 置 与 包 的 结构 一 致 。 
(2) 在 Web 应 用 的 web.xml 文件 中 配置 使 用 的 Servlet 和 Servlet 过 滤器 ， 也 就 是 在 
web.xml 文件 中 添加 如 下 代码 : 
<!-- 配置 Servlet 一 > 
<servlet> 
<servlet-name>textModifier</servlet-name> 


<servlet-class>cn.ac.ict.Servlet. TextModiferServlet</servlet-class> 
</servlet> 


<servlet-mapping> 
<servlet-name>textModifier</servlet-name> 
<url-pattern>/textModifier</url-pattern> 
</servlet-mapping> 
<!-- 配置 Servlet 过 滤器 --> 
<filter> 
<filter-name>Text Content Modifier</filter-name> 


<filter-class>cn.ac.ict.Filter. TextModifierFilter</filter-class> 
</filter> 


<filter-mapping> 
<filter-name>Text Content Modifier</filter-name> 
<url-pattern>/textModifier</url-pattern> 
</filter-mapping> 
(3) 启动 Tomcat 或 者 重新 加 载 Web 应 用 ， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : 
http://localhost:8080/14/textModifier.jsp， 并 填写 内 容 ， 显 示 页 面 如 图 14.2 所 示 。 
(4) 可 以 看 到 用 户 的 留言 中 包含 了 字符 串 search。 提 交 后 可 以 看 到 页 面 显示 如 网 14.3 
所 示 。 
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图 14.3 ”过 滤 效 果 
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14.5 Servlet 监听 器 简介 


Servlet 监听 器 与 Servlet 过 滤器 的 很 多 特性 是 一 致 的 , 它 的 很 多 概念 与 Java 中 的 监听 器 
的 概念 也 是 一 致 的 。 它 可 以 在 特定 事件 发 生 时 监听 到 ， 并 根据 其 作出 相应 的 反应 。 

Servlet 监听 器 是 在 Servlet 2.3 版 中 引入 的 技术 , 它 可 以 监听 客户 端的 请 求 、 服 务 端的 操 
作 等 。Servlet 监听 器 是 比较 容易 理解 的 。 下 面 介绍 Servlet 监听 器 常用 类 和 接口 并 举例 讲述 
如 何 使 用 Servlet 监听 器 。 


14.5.1 监听 服务 器 ServletContext 对 象 


对 ServletContext 对 象 进行 监听 的 接口 有 : ServletContextAttributeListener 和 Servlet 
ContextListener， 它 们 可 以 分 别 用 于 监听 ServletContext 对 象 中 属性 的 变化 和 ServletContext 
对 象 本 身 的 变化 。 

下 面 对 这 两 个 接口 作 一 简单 介绍 ， 首 先 介绍 ServletContextAttributeListener 接口 。 

实现 ServletContextAttributeListener 接 口 的 监听 器 可 以 监听 到 ServletContext 对 象 中 属性 
的 变化 ， 它 提供 的 方法 有 : 

口 voidattributeAdded(ServletContextAttributeEvent scab)。 

口 voidattributeRemoved(ServletContextAttributeEvent scab)。 

口 void attributeReplaced(ServletContextAttributeEvent scab)。 

实现 ServletContextAttributeListener 接口 可 以 监听 对 ServletContext 属性 的 操作 , 当 进行 
增加 、 删 除 、 修 改 等 操作 时 ， 都 会 调用 相应 的 方法 。 

口 当 在 ServletContext 增加 一 个 属性 时 ， 激 发 attributeAdded(ServletContextAttribute 


Event scab) 方 法 。 
口 当 在 ServletContext 删除 一 个 属性 时 ， 激 发 attributeRemoved(ServletContextAttribute 
Event scab) 方 法 。 


口 当 在 ServletContext 属性 被 重新 设置 时 ， 激 发 attributeReplaced(ServletContext 
AttributeEvent scab) 方 法 。 
下 面 介绍 ServletContextListener 接口 ， 实 现 ServletContextListener 接口 的 监听 器 可 以 监 

听 ServletContext 对 象 本 身 的 变化 ， 它 提供 的 方法 有 : 


口 void contextDestroyed(ServletContextEvent sce)。 


口 void contextInitialized(ServletContextEvent sce)。 

实现 ServletContextListener 接口 可 以 监听 ServletContext 的 操作 。 

口 当 创 建 ServletContext 时 ， 激 发 contextInitialized(ServletContextEvent sce) 方 法 。 
口 当 销 毁 ServletContext 时 ， 激 发 contextDestroyed(ServletContextEvent sce) 方 法 。 


。278。 JSP 网 络 开发 技术 及 整合 应 用 


14.5.2 ”监听 客户 会 话 


对 客户 会 话 进行 监听 的 接口 有 : HttpSessionListener 接口 、HttpSessionAttributeListener 
接口 、HttpSessionActivationListener 接口 和 HttpSessionBindingListener 接口 ， 它 们 可 以 分 别 
了 于 监听 HttpSession 对 象 中 属性 的 变化 和 HttpSession 对 象 本 身 状 态 的 变化 。 

下 面 对 前 3 个 接口 作 一 简单 介绍 ， 首 先 介绍 HttpSessionAttributeListener 接口 。 
实现 HttpSessionAttributeListener 接口 的 监听 器 可 以 监听 到 HttpSession 对 象 中 属性 的 变 
化 ， 它 提供 的 方法 有 : 
口 void attributeAdded(HttpSessionBindingEvent se)。 
口 void attributeRemoved(HttpSessionBindingEvent se)。 


口 void attributeReplaced(HttpSessionBindingEvent se)。 

实现 HttpSessionAttributeListener 接口 可 以 监听 HttpSession 中 属性 的 操作 。 

口 当 在 Session 增加 一 个 属性 时 ,激发 attributeAdded(HttpSessionBindingEvent se) 方 法 。 

口 当 在 Session 删除 一 个 属性 时 ， 激 发 attributeRemoved(HttpSessionBindingEvent se) 
方法 。 

口 当 在 Session 属性 被 重新 设置 时 , 激发 attributeReplaced(HttpSessionBindingEvent se) 
方法 。 

下 面 介 绍 HttpSessionListener 接口 ， 实 现 HttpSessionListener 接口 的 监听 器 可 以 监听 

HttpSession 对 象 本 身 的 创建 和 销毁 ， 它 提供 的 方法 有 : 

口 void sessionCreated(HttpSessionEvent se)。 

口 void sessionDestroyed(HttpSessionEvent se)。 

实现 HttpSessionListener 接口 的 监听 器 可 以 监听 HttpSession 的 操作 。 

口 当 创 建 一 个 Session 时 ， 激 发 sessionCreated(HttpSessionEvent se) 方 法 。 

口 当 销 毁 一 个 Session 时 ， 激 发 sessionDestroyed (HttpSessionEvent se) 方 法 。 

HttpSessionActivationListener 接口 用 于 监听 HttpSession 对 象 的 状态 ， 它 提供 的 方法 有 : 

口 void sessionDidActivate(HttpSessionEvent se)。 

口 void sessionWillPassivate(HttpSessionEvent se)。 

实现 HttpSessionActivationListener 接口 可 以 监听 HttpSession 对 象 是 被 激活 还 是 钝 化 。 

口 当 激 活 一 个 HttpSession 对 象 时 激发 sessionDidActivate(HttpSessionEvent se) 方 法 。 

口 当 钝 化 一 个 HttpSession 对 象 时 激发 sessionWillPassivate (HttpSessionEvent se) 方 法 。 


14.5.3 ”监听 客户 请 求 


对 ServletRequest 对 象 进行 监听 的 接口 有 :ServletRequestAttributeListener 和 ServletRequest 
Listener， 这 个 是 Servlet 2.4 版 本 的 新 增 监听 器 ,它们 可 以 分 别 用 于 监听 ServletRequest 对 象 
中 属性 的 变化 和 ServletRequest 对 象 本 身 的 变化 。 

下 面 对 这 两 个 接口 作 一 简单 介绍 ， 首 先 介 绍 ServletRequestAttributeListener 接口 : 
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实现 ServletRequestAttributeListener 接口 的 监听 器 可 以 监听 到 ServletRequest 对 象 中 属 
性 的 变化 ， 它 提供 的 方法 有 : 

口 void attributeAdded(ServletRequestAttributeEvent scab) 。 

口 void attributeRemoved(ServletRequestAttributeEvent scab)。 

口 void attributeReplaced(ServletRequestAttributeEvent scab) 。 

实现 ServletRequestAttributeListener 接口 可 以 监听 对 ServletRequest 属性 的 操作 ， 当 进 
行 增加 、 删 除 、 修 改 等 操作 时 ， 都 会 调用 相应 的 方法 。 

口 当 在 ServletRequest 增加 一 个 属性 时 ， 激 发 attributeAdded(ServletRequestAttribute 


Event scab) 方 法 。 
口 当 在 ServletRequest 删除 一 个 属性 时 , 激发 attributeRemoved(ServletRequestAttribute 
Event scab) 方 法 。 


口 当 在 ServletRequest 属性 被 重新 设置 时 ， 激 发 attributeReplaced(ServletRequest 
AttributeEvent scab) 方 法 。 
下 面 介 绍 ServletRequestListener 接口 , 实现 ServletRequestListener 接口 的 监听 器 可 以 监 
听 ServletRequest 对 象 本 身 的 变化 ， 它 提供 的 方法 有 : 


口 void requestDestroyed(ServletRequestEvent sce)。 


口 void requestInitialized(ServletRequestEvent sce)。 

实现 ServletRequestListener 接口 可 以 监听 ServletRequest 的 操作 。 

口 当 创建 ServletRequest 时 ， 激 发 requestInitialized(ServletRequestEvent sce) 方 法 。 
口 当 销 毁 ServletRequest 时 ， 激 发 requestDestroyed(ServletRequestEvent sce) 方 法 。 


14.6 ”网 站 计数 器 实例 一 一 使 用 Servlet 监听 器 


在 本 节 介 绍 一 个 使 用 Servlet 监听 器 对 网 站 访问 量 进行 统计 的 一 个 应 用 ， 在 这 个 例子 中 
使 用 了 上 面 介 绍 的 大 部 分 接口 ， 下 面 就 通过 分 析 这 个 例子 介绍 如 何 编写 Servlet 监听 器 。 下 
面 是 这 个 监听 器 实现 类 的 源 代码 : 


package cn.ac.ict.Listener; 


import javax.servlet.ServletContextAttributeEvent; 
import javax.servlet.ServletContextAttributeListener' 
import javax.servlet.ServletRequestEvent; 

import javax.servlet.ServletRequestListener; 

import javax.servlet.http.HttpSessionEvent; 

import javax.servlet.http.HttpSessionListener; 


public class CountHitListener implements HttpSessionListener, 
ServletContextAttributeListener, ServletRequestListener { 
private int count ,hit; 
public CountHitListener(){ 
count = 0; 
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// 创 建 一 个 会 话 时 激发 ， 将 访问 人 数 加 1 

public void sessionCreated(HttpSessionEvent arg0) { 
Count++; 
setContext(arg0); 


} 


// 设 置 context 的 属性 ， 将 计数 器 的 值 保存 在 ServletContext 对 象 中 
// 将 会 激发 attributeAdded 或 者 attributeReplaced 方 法 (没有 实现 接口 ， 这 些 方法 在 这 个 类 中 
不 存在 ) 
private void setContext(HttpSessionEvent arg0) { 
arg0.getSession().getServletContext().setAttribute("Counter",new Integer(count)); 


} 

// 销 毁 一 个 会 话 时 激发 ， 将 访问 数 减 1 

public void sessionDestroyed(HttpSessionEvent arg0) { 
count--; 
setContext(arg0); 


} 


// 在 ServletContext 的 对 象 中 新 添加 一 个 属性 时 激发 
public void attributeAdded(ServletContextAttributeEvent arg0) { 


} 


// 在 ServletContext 的 对 象 中 删除 一 个 属性 时 激发 
public void attributeRemoved(ServletContextAttributeEvent arg0) { 


} 


// 在 ServletContext 的 对 象 中 一 个 属性 被 替换 时 激发 
public void attributeReplaced(ServletContextAttributeEvent arg0) { 


} 


// 一 个 请 求 结束 时 激发 
public void requestDestroyed(ServletRequestEvent arg0){ 


// 一 个 请 求 来 临时 激发 

public void requestlnitialized(ServletRequestEvent arg0) { 
hit++; 
this.setContext(arg0); 


} 
// 设 置 ServletRequest 对 象 的 属性 
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private void setContext(ServletRequestEvent arg0){ 
arg0.getServletContext().setAttribute("Hiter",new Integer(hit)); 
} 
} 


发 布 这 个 监听 器 时 需要 在 Web 应 用 的 web.xml 文件 中 添加 如 下 代码 : 


<listener> 
<listener-class>cn.ac.ict.Listener.CountHitListener</listener-class> 
</listener> 
下 面 编写 一 个 简单 的 查看 访问 量 的 JSP 页 面 ， 代 码 如 下 : 
<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import ="java.lang.”%> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 
<head> 
<title> 显 示 网 站 在 线 用 户 数 和 页 面 点 击 量 </title> 
</head> 
<body bgcolor="#FFFFFF"> 
<% 
int count =((Integer) application.getAttribute("Counter )).intValue(); 
int hit = ((Integer) application.getAttribute("Hiter )).intValue(); 
%> 
本 站 总 线 人 数 为 : <%=count%> 
页 面 的 点 击 量 为 : <%=hit%> 
</body> 
</html> 


下 面 介绍 这 个 监听 器 监测 在 线 用 户 数量 时 的 执行 过 程 ， 如 图 14.4 所 示 。 


调用 构造 器 (在 线 人 数 为 
Web 应 用 启动 > 0) 和 contextInitialized 


Web 客 户 访 问 和 9、 调用 sessionCreated, 在 
线 人 数 加 1， 并 保存 到 


ServletContext 
1 


调用 attributeAdded 或 二- 
者 attributeReplaced 


1 

i 

调用 sessionDestroyed， | 

Web 客 户 离开 在 线 人 数 减 1， 并 保存 到 ----- 


ServletContext 


Web 应 用 关闭 若 ” 调 用 contextDestroyed 


图 14.4 在 线 人 数 统计 分 析 
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从 图 14.4 可 以 看 到 ，Servlet 监听 器 提供 服务 的 过 程 如 下 : 

(1) 当 Web 应 用 启动 时 ，ServletContext 第 一 次 建立 ， 这 时 ， 调 用 Listener 的 构造 器 和 
contextInitialized 对 这 个 程序 进行 一 些 初始 化 设置 。 

(2) Web 应 用 启动 后 ， 就 可 以 等 待 Web 客户 的 访问 了 。 当 一 个 新 的 客户 来 到 时 ， 它 
会 新 开始 一 个 会 话 ， 这 时 调用 sessionCreated 方法 ， 将 在 线 人 数 加 1， 并 把 这 个 数值 对 象 作 
为 属性 加 入 到 ServletContext 中 。 

(3) 上 述 操 作 造 成 了 ServletContext 属性 的 变更 ， 如 果 是 第 一 个 客户 ， 就 会 调用 
attributeAdded 方法 , 否则 就 会 调用 attributeReplaced 方法 , 在 这 些 方法 中 是 不 需要 做 任何 事 
情 的 ， 所 以 程序 中 这 些 方 法 都 不 需要 实现 ， 因 此 都 为 空 。 

(4) 客户 离开 这 个 Web 应 用 时 ， 就 结束 了 一 个 会 话 ， 监 听 器 会 调用 sessionDestroyed 
方法 ， 把 在 线 人 数 减 1， 并 把 更 改 后 的 数值 存储 到 ServletContext 对 象 中 。 

(5) 上 述 操作 也 造成 了 ServletContext 属性 的 变更 ， 会 调用 attributeReplaced 方法 。 

(6) 当 Web 应 用 被 关闭 或 者 Tomcat 服务 器 被 关闭 时 ， 一 个 ServletContext 对 象 被 销 
筑 ， 这 时 监听 器 调用 contextDestroyed 方法 。 

将 这 个 Web 应 用 发 布 后 ,在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/14/Show 
Counter.jsp， 可 能 的 页 面 显示 如 图 14.5 所 示 。 
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Servlet 监听 器 和 过 滤器 是 Servlet 2.3 后 新 增加 的 一 个 重要 特性 , 在 很 多 应 用 中 体现 了 很 
大 的 优势 。 在 本 章 中 介绍 了 Servlet 监听 器 和 过 滤器 的 工作 原理 和 使 用 方法 ， 希 望 读 者 多 多 
练习 ， 更 好 地 理解 它们 的 工作 原理 。 
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计算 机 网 络 的 安全 问题 是 一 个 让 很 多 网 络 管理 员 头 疼 的 问题 ， 作 为 网 络 中 的 服务 器 ， 
它 暴露 给 很 多 用 户 ， 同 时 也 增加 了 被 入 侵 的 风险 。 在 提高 应 用 的 安全 性 方面 ， 除 了 使 用 防 
火 墙 以 及 其 他 一 些 安全 措施 外 ， 使 用 JSP 技术 提高 Web 应 用 的 安全 性 也 是 很 重要 的 方面 ， 
在 本 章 中 将 介绍 如 何 使 用 JSP 技术 及 其 相关 的 容器 提高 Web 应 用 的 安全 性 。 


15.1 JSP/Servlet 容器 认证 


Servlet 规范 中 定义 了 一 些 组 件 用 于 实现 容器 认证 的 安全 性 ， 它 是 通过 web.xml 文件 中 
的 <security-constraint> 元 素 、<login-config> 元 素 和 <security-role> 元 素 体 现 的 ， 下 面 分 别 介绍 
这 3 个 元 素 。 

1. <security-constraint> 元 素 

<security-constraint> 元 素 用 来 指定 受 保护 的 Web 资源 以 及 所 有 可 以 访问 该 Web 资源 的 
角色 。 例 如 在 Tomcat 的 Manager 应 用 中 定义 了 如 下 的 <security-constraint> 元 素 : 


< 上 -一 对 这 个 Web 应 用 定义 了 一 个 安全 限制 --> 

<Security-constraint> 

<!-- ”指定 受 包含 的 资源 -一 > 

<web-resource-collection> 

<web-resource-name>HTMLManger and Manager command</web-resource-name> 
<url-pattern>/jmxproxy/*</url-pattern> 
<url-pattern>/html/*</url-pattern> 
<url-pattern>/list</url-pattern> 
<url-pattern>/sessions</url-pattern> 
<url-pattern>/start</url-pattern> 
<url-pattern>/stop</url-pattern> 
<url-pattern>/install</url-pattern> 
<url-pattern>/remove</url-pattern> 
<url-pattern>/deploy</url-pattern> 
<url-pattern>/undeploy</url-pattern> 
<url-pattern>/reload</url-pattern> 
<url-pattern>/save</url-pattern> 
<url-pattern>/serverinfo</url-pattern> 
<url-pattern>/status/*</url-pattern> 
<url-pattern>/roles</url-pattern> 
<url-pattern>/resources</url-pattern> 
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</web-resource-collection> 


<auth-constraint> 
<!-- 注意 : 这 个 角色 在 默认 的 用 户 文件 中 是 不 存在 的 --> 
<role-name>manager</role-name> 
</auth-constraint> 
</security-constraint> 


在 这 个 <security-constraint> 元 素 的 定义 中 ，<web-resource-collection> 元 素 定义 了 所 有 受 
保护 的 Web 资源 , 而 <auth-constraint> 子 元 素 定 义 了 可 以 访问 这 些 保护 的 Web 资源 的 角色 为 
Manager。 


<security-constraint> 元 素 还 有 一 些 其 他 的 子 元 素 ， 如 表 15.1 所 示 。 


表 15.1 security-constraint 元 素 的 子 元 素 


玫 元 案 描述 
<web-resource-collection> | 声明 受 保护 的 Web 资 源 
<web-resource-name> 指定 受 保护 资源 的 名 字 ，<web-resource-collection> 的 子 元 素 
<url-pattern> 受 保护 资源 的 URL 路 径 ，<web-resource-collection> 的 子 元 素 


指定 受 保护 的 HTTP 访 问 方 法 〈 包 括 DELETE、GET、POST、PUT) ， 如 果 


区 不 定义 ， 表 示 所 有 的 方法 都 受 保护 ， 为 <web-resource-collection> 的 子 元 素 


<auth-constraint> 彰 定 受 保护 资源 的 安全 限制 
<role-name> 指定 可 以 访问 受 保护 资源 的 角色 名 ， 为 <auth-constraint> 的 子 元 素 


2. <login-config> 元 素 
<login-config> 元 素 用 来 指定 Web 客户 访问 受 保护 的 Web 资源 时 , 系统 对 客户 进行 验证 
的 类 型 (具体 表现 为 弹出 不 同 登 录 对 话 框 ) 。 其 中 ， 在 Manager 应 用 中 定义 了 如 下 的 
<login-config> 元 素 : 
<login-config> 
<auth-method>BASIC</auth-method> 
<realm-name>Tomcat Manager Application</realm-name> 


</login-config> 
当 访 问 Manager 应 用 时 会 弹出 一 个 对 话 框 ， 如 图 15.1 所 示 。 
Hy 
Eo 
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图 15.1 BASIC 验证 方式 


这 就 是 使 用 BASIC 的 验证 方式 。 下 面 先 介绍 <login-config> 元 素 的 子 元 素 ， 然 后 介绍 几 
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种 不 同 的 验证 方式 。 
<login-config> 元 素 的 子 元 素 如 表 15.2 所 示 。 
表 15.2 ”<login-config> 元 素 的 子 元 素 
子 元 素 描 ” 述 
<auth-method> 系统 对 客户 进行 验证 的 类 型 ， 有 BASIC、DIGEST 和 FORM 3 种 类 型 
<realm-name> 设 定 使 用 的 Realm 名 称 
<form-login-config> 使 用 FORM 验 证 时 的 配置 信息 
<form-login-page> 使 用 FORM 验 证 时 的 登录 页 面 
<form-error-page> 使 用 FORM 验 证 时 的 错误 处 理 页 面 
例如 在 admin 应 用 中 定义 的 <login-config> 元 素 如 下 : 
<login-config> 


<auth-method>FORM</auth-method> 
<realm-name>Tomcat Server Configuration Form-Based Authentication Area</realm-name> 
<form-login-config> 
<form-login-page>/login.jsp</form-login-page> 
<form-error-page>/error.jsp</form-error-page> 
</form-login-config> 
</login-config> 
在 上 面 的 介绍 中 , 可 以 知道 系统 对 客户 进行 验证 的 类 型 , 有 BASIC、DIGEST 和 FORM 
3 种 类 型 ， 在 后 面 将 会 分 别 对 这 3 种 类 型 作 简单 的 介绍 。 
3. <security-role> 元 素 
<security-role> 元 素 用 于 声明 Web 应 用 引用 的 角色 名 字 ， 其 中 ， 在 Manager 应 用 中 定义 
了 如 下 的 <security-role> 元 素 : 
<security-role> 
<description> 
The role that is required to log in to the Manager Application 
</description> 
<role-name>manager</role-name> 
</security-role> 


<security-role> 元 素 只 有 两 个 子 元 素 ， 分 别 介绍 如 下 : 
口 <description>: 对 当前 的 <security-role> 元 素 进行 描述 。 
口 <role-name>: 引用 的 角色 名 称 ， 对 于 多 个 名 称 要 使 用 多 个 <role-name>。 


15.1.1 使 用 基本 认证 〈BASIC ) 


当 有 客户 访问 使 用 BASIC 验证 方式 保护 Web 资源 时 ，Tomcat 通过 HTTP Basic 
Authentication 方式 弹出 一 个 对 话 框 〈 如 图 15.1 所 示 ) 要 求 用 户 输入 用 户 名 和 密码 。 在 这 种 
验证 方式 中 ， 密 码 都 是 以 64 位 的 编码 方式 在 网 络 上 传输 的 。 
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使 用 Basic Authentication 通常 被 认为 是 不 安全 的 , 因为 它 没有 强健 的 加 密 方 法 , 除非 在 
客户 端 和 服务 器 端 都 使 用 HTTPS 或 者 其 他 密码 加 密 方式 〈 比 如 在 一 个 虚拟 私人 网 络 中 ) 。 
若 没 有 额外 的 加 密 方法 ， 网 络 管理 员 将 能 够 截获 〈 或 滥用) 用 户 的 密码 。 


15.1.2 ”使 用 摘要 认证 (DIGEST) 


DIGEST 指出 客户 机 应 该 利用 加 密 Digest 习 
Authentication 形式 传输 用 户 名 和 口令 , 这 提供 了 比 Ce a he ee 二 
se 了 Tomeat Wanager Application 户 名 
BASIC 验证 更 高 的 防范 网 络 截取 的 安全 性 。 可 这 


L  _ _ | 
如 果 把 Manager 应 用 中 的 验证 方法 由 BASIC 一 一 一 


改 为 DIGEST， 它 会 弹出 如 图 15.2 所 示 的 对 话 框 。 
| 
15.1.3 ”使 用 基于 表单 的 认证 (FORM) 图 15.2 DIGEST 验证 


FORM 验证 顾名思义 ， 就 是 通过 表单 验证 的 方式 (BASIC 和 DIGEST 验证 是 通过 弹出 
标准 对 话 框 进行 验证 的 ) 。 

要 定义 一 个 FORM 验证 除了 像 其 他 的 验证 方式 那样 指定 验证 方式 外 ， 还 需要 指定 登录 
页 面 和 错误 处 理 页 面 。 用 户 提 供 的 验证 页 面 中 必须 提供 一 个 登录 表单 ， 表 单 中 的 用 户 名 和 
密码 文本 框 的 名 字 必 须 是 j username 和 j_password， 而 且 表单 的 action 的 值 必须 是 
j security_check。 

下 面 介 绍 一 个 简单 的 验证 页 面 和 错误 处 理 页 面 ， 进 行 表单 验证 ， 下 面 是 登录 页 面 
login.jsp 的 源 代码 : 

<%@ page contentType="text/html;charset=gb2312"%> 

<html><head><tile>FORM 验证 </tile></head> 

<body> 


<form action="j_security_check" method="post" > 
<center> 
<table> 
<tr> 
<td >Username:</td> 
<td ><input type="text" name="j_username'" size="25"></td> 
</tr> 
<tr> 
<td >Password:</td> 
<td ><input type="password" name="]j_password" size="25"></td> 
</tr> 
</table> 


</center> 
<center><br> 
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<input type="submit" value="Login"> 
<input type="reset" name="Reset" value="Reset"> 
</center> 
</form> 


</body> 
</html> 


下 面 创建 一 个 错误 处 理 页 面 errorpagejsp， 其 源 代码 如 下 : 


<%@ page contentType="text/html;charset=gb2312"%> 
<html><head><title>Error Page</title></head> 
<body> 
<p><font color=red size=+1> 
<b> 用 户 名 或 密码 错误 </b> 
</font></p> 
</body></html> 


在 TomcatConfig 应 用 的 web.xml 文件 中 加 入 如 下 代码 : 


<security-constraint> 

<display-name>Example Security Constraint</display-name> 

<web-resource-collection> 
<web-resource-name>Protected Area</web-resource-name> 

<!-- Define the context-relative URL(s) to be protected --> 

<!-- ”只 有 列 出 的 方法 是 受 保护 的 --> 

<http-method>DELETE</http-method> 
<http-method>GET</http-method> 
<http-method>POST</http-method> 

<http-method>PUT</http-method> 

</web-resource-collection> 

<auth-constraint> 
<!-- Anyone with one of the listed roles may access this area --> 
<role-name>manager</role-name> 

</auth-constraint> 

</security-constraint> 


<!-- ”配置 使 用 FORM 的 方式 进行 验证 -> 
<login-config> 
<auth-method>FORM</auth-method> 
<realm-name>Example Form-Based Authentication Area</realm-name> 
<form-login-config> 
<form-login-page>/login.jsp</form-login-page> 
<form-error-page>/errorpage.jsp</form-error-page> 
</form-login-config> 
</login-config> 


这 样 就 配置 好 了 一 个 FORM 验证 , 在 浏览 器 中 访问 TomcatConfig 应 用 的 某 个 页 面 ， 它 
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会 首先 显示 login.jsp 页 面 ， 要 求 输入 用 户 名 和 密码 ， 效 果 如 图 15.3 所 示 。 
如 果 输 入 了 错误 的 用 户 名 和 密码 则 会 跳 转 到 errorpage.jsp 页 面 ， 如 图 15.4 所 示 。 
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15.2 为 Web 应 用 配置 使 用 SSL 


15.2.1 SSL 简介 


SSL (Secure Socket Layer) ， 安 全 套 接 字 协议 层 是 Internet 上 领先 的 安全 协议 机 制 ， 它 
是 由 Netscape 公司 开发 的 主要 用 于 Web 的 安全 传输 协议 。 当 SSL 会 话 开 始 后 ， We 浏览 器 
将 公共 密 钥 发 送 给 Web 服务 器 ， 这 样 服务 器 可 以 很 安全 地 将 私人 密 钥 发 送 给 浏览 器 。 浏 览 
器 和 服务 器 在 会 话 期 间 , 用 私人 密 钥 加 密 数 据 。 这 种 协议 在 Web 上 获得 了 广泛 的 应 用 。TLS 

(Transport Layer Security) 、IETF (www.ietforg) 将 SSL 作 了 标准 化 ， 即 RFC2246， 并 将 
其 称 为 TLS。 

采用 SSL 的 HTTP 称 为 HTTPS 协议 ， 其 使 用 的 默认 端口 是 443， 而 HTTP 使 用 的 默认 
协议 是 80。 下 面 介 绍 数字 安全 证 书 的 概念 和 SSL 的 工作 原理 。 

1. 数字 安全 证 书 

数字 安全 证 书 是 网 络 通信 中 标志 通信 各 方 身份 信息 的 一 系列 数据 ， 提 供 了 一 种 在 
Internet 上 验证 用 户 身份 的 方式 ， 它 一 般 是 由 一 个 由 权威 机 构 一 一 CA 机 构 ， 又 称 为 证 书 授 
权 (Certificate Authority) 中 心 发 行 的 ， 人 们 可 以 在 交往 中 用 它 来 识别 对 方 的 身份 。 数 字 证 
书 是 一 个 经 证 书 授权 中 心 数 字 签 名 的 包含 公开 密 钥 拥 有 者 信息 以 及 公开 密 钥 的 文件 。 最 简 
单 的 证 书包 含 一 个 公开 密 钥 、 名 称 以 及 证 书 授权 中 心 的 数字 签名 。 一 般 情况 下 证 书 中 还 包 
括 密 钥 的 有 效 时 间 、 发 证 机 关 “【〈 证 书 授权 中 心 ) 的 名 称 、 该 证 书 的 序列 号 等 信息 ， 证 书 的 
格式 遵循 ITUT X.509 国际 标准 。 

2. SSL 工作 原理 

当 客户 浏览 器 与 一 个 网 站 建立 HTTPS 连接 时 , 用 户 的 浏览 器 与 Web Server 之 间 要 经 过 
一 个 握手 的 过 程 来 完成 身份 鉴定 与 密 钥 交换 ， 从 而 建立 安全 连接 。 具 体 过 程 如 下 : 

口 用 户 浏览 器 将 其 SSL 版 本 号 、 加 密 设置 参数 、 与 Session 有 关 的 数据 以 及 其 他 一 些 

必要 信息 发 送 到 服务 器 。 
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服务 器 将 其 SSL 版 本 号 、 加 密 设 置 参 数 、 与 Session 有 关 的 数据 以 及 其 他 一 些 必 要 
信息 发 送 给 浏览 器 ， 同 时 发 给 浏览 器 的 还 有 服务 器 的 证 书 。 如 果 配 置 服务 器 的 SSL 
需要 验证 用 户 身 份 ， 还 要 发 出 请 求 要 求 浏览 器 提供 用 户 证 书 。 

客户 端 检 查 服务 器 证 书 ， 如 果 检 查 失败 ， 提 示 不 能 建立 SSL 连接 。 如 果 成 功 ， 那 
么 继续 。 

客户 端 浏 览 器 为 本 次 会 话 生 成 pre-master secret, 并 将 其 用 服务 器 公 钥 加 密 后 发 送 给 
服务 器 。 

如 果 服 务 器 要 求 鉴别 客户 身份 , 客户 端 还 要 再 对 另外 一 些 数据 签名 后 并 将 其 与 客户 
端 证 书 一 起 发 送 给 服务 器 。 

如 果 服 务 器 要 求 鉴别 客户 身份 ， 则 检查 签署 客户 证 书 的 CA 是 否 可 信 。 如 果 不 在 信 
任 列表 中 ， 结 束 本 次 会 话 。 如 果 检 查 通过 ， 服 务 器 用 自己 的 私 钥 解 密 收 到 的 
pre-master secret， 并 用 它 通 过 某 些 算法 生成 本 次 会 话 的 master secret。 

客户 端 与 服务 器 均 使 用 此 master secret 生成 本 次 会 话 的 会 话 密 钥 (对 称 密 钥 )。 在 
双方 SSL 握手 结束 后 传递 任何 消息 均 使 用 此 会 话 密 钥 。 这 样 做 的 主要 原因 是 对 称 
加 密 比 非 对 称 加 密 的 运算 量 低 一 个 数量 级 以 上 ， 能 够 显著 提高 双方 会 话 时 的 运算 
客户 端 通知 服务 器 此 后 发 送 的 消息 都 使 用 这 个 会 话 密 钥 进行 加 密 , 并 通知 服务 器 客 


户 端 已 经 完成 本 次 SSL 握手 。 
口 服务 器 通知 客户 端 此 后 发 送 的 消息 都 使 用 这 个 会 话 密 钥 进行 加 密 
务 器 已 经 完成 本 次 SSL 握手 。 


， 并 通知 客户 端 服 


口 本 次 握手 过 程 结束 , 会 话 已 经 建立 。 双方 使 用 同一 个 会 话 密 钥 分 别 对 发 送 以 及 接收 


的 信息 进行 加 、 解 密 。 


15.2.2 ”在 Tomcat 中 为 Web 应 用 配置 使 用 SSL 


Tomcat 是 一 个 优秀 的 JSP/Servlet 容器 ， 它 可 以 作为 单独 的 Web 服务 器 ,当然 也 可 以 在 


其 上 配置 使 用 SSL， 配 置 SSL 需要 两 个 步骤 : 
(1) 准备 安全 证 书 。 
(2) 配置 SSL 连接 器 。 
下 面 就 按照 这 两 步 在 Tomcat 上 配置 SSL。 


1. 准备 安全 证 书 


在 前 面 介绍 到 数字 安全 证 书 一 般 是 由 证 书 授权 中 心 发 行 的 ， 但 事实 上 也 可 以 自己 制作 


自己 的 安全 证 书 ， 不 过 它 不 具有 权威 性 ， 也 就 是 说 ， 当 客户 看 到 安全 证 二 


世上 的 信息 时 ， 并 


不 能 确定 上 面 的 信息 和 提供 者 的 真实 信息 ， 但 使 用 自制 的 安全 证 书 可 以 保证 网 络 上 双方 交 


换 的 信息 不 被 窜改 。 下 面 介绍 如 何 创 建 自己 的 安全 证 书 。 


Sun 提供 了 制作 安全 证 书 的 工具 keytool. 对 于 JDK 1.4 以 上 版 本 可 以 在 <JAVA_HOME> 
/bin 下 找到 这 个 工具 ， 对 于 低 版 本 的 JDK， 也 可 以 到 Sun 的 网 站 下 载 这 个 工具 : 
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http://java.sun.com/products/jisse/downloads/index.html 


(1) 打开 DOS 窗口 (不 需要 修改 运行 目录 ) ， 使 用 如 下 命令 创建 安全 证 书 : 
keytool -genkey -alias tomcat -keyalg RSA 
其 中 各 个 选项 的 意义 如 下 : 
0 -genkey: 生成 密 钥 对 (如 果 没 有 ) 。 
口 -alias: 指定 密 钥 对 的 史 名 ， 该 别名 是 公开 的 ， 这 里 指定 为 Tomcat。 
口 -keyalg: 指定 加 密 算法 ， 这 里 采用 比较 通用 的 算法 A 
(2) 运行 命令 后 可 以 看 到 提示 信息 ， 输 入 keystore 的 密码 ， 这 里 输入 Tomcat 的 默认 
密码 changit， 默 认 的 用 户 名 就 是 命令 中 指定 的 Tomcat。 
(3) 输入 一 些 个 人 信息 
(4) 在 提示 输入 信息 是 否 正 确 时 ， 输 入 y 表 示 信 息 正 确 。 
(5) 输入 Tomcat (上 面 alias 的 名 字 ) 的 主 密码 ， 
了 〔 按 回 车 键 ) ， 效 果 如 图 15.5 所 示 。 
这 样 就 可 以 在 Windows 的 个 人 账户 目录 (C:\Documents and Settings\<UserName>) 下 
找到 一 个 .keystore 文件 ， 这 就 是 keytool 生成 的 一 个 非 对 称 密 钥 和 自我 签名 的 证 书 。 


命令 提示 符 


这 里 设置 为 与 keystore 相同 就 可 以 


图 15.5 ”用 keytool 生成 的 安全 证 书 
2. 配置 SSL 连接 器 

在 Tomcat 的 Server.xml 中 提供 了 配置 SSL ji 
掉 就 可 以 了 ， 其 代码 如 下 : 


<Connector port="8443" 


连接 器 的 代码 ， 只 要 把 Connector 的 注释 去 


maxThreads="150" minSpareThreads="25" maxSpareThreads="75" 
enableLookups="false" disableUploadTimeout="true" 
acceptCount="100" debug="0" scheme="https" secure="true" 
clientAuth="false" sslProtocol="TLS" /> 


基于 SSL 的 HTTP (HTTPS) 的 默认 端口 为 443， 这 里 将 其 改 为 8443。Connector 的 一 
些 常 用 的 配置 属性 的 描述 如 表 15.3 所 示 。 
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表 15.3 ”Connector 的 一 些 常用 的 配置 属性 
属 性 描述 
如 果 想 要 Tomcat 为 了 使 用 这 个 socket 而 要 求 所 有 SSL 客 户 出 示 一 个 客户 证 书 ， 置 该 值 为 
true 
如 果 创 建 的 keystore 文 件 不 在 Tomcat 认 为 的 默认 位 置 〈 一 个 在 Tomcat 运 行 的 home 目 录 
keystoreFile 下 的 叫做 .keystore 的 文件 ) ， 则 加 上 该 属性 。 可 以 指定 一 个 绝对 路 径 或 依赖 
SCATALINA_BASE 环 境 变量 的 相对 路 径 
keystorePass 如 果 使 用 了 一 个 与 Tomcat 预 期 不 同 的 keystore〈 和 证 书 》 密码 ， 则 加 入 该 属性 


keystoreType “| 如 果 使 用 了 一 个 PKCS12 keystore， 加 入 该 属性 。 有 效 值 是 JKS 和 PKCS12 
socket 使 用 的 加 密 /解密 协议 。 如 果 使 用 的 是 Sun 的 JVM, 则 不 建议 改变 这 个 值 。 据 说 IBM 


clientAuth 


sslProtocol | 的 1.4.1 版 的 TLS 协 议 的 实现 和 一 些 流行 的 浏览 器 不 兼容 ， 这 种 情况 下 使 用 SSL 

ciphers 此 socket 人 允许 使 用 的 被 逗号 分 隔 的 密码 列表 。 默 认 情 况 下 ， 可 以 使 用 任何 可 用 的 密码 
使 用 的 X509 算 法 。 默 认为 Sun 的 实现 (SunX509) 。 对 于 IBM JVMS 应 该 使 用 ibmX509。 

Werth 对 于 其 他 JVM， 可 以 参考 JVM 文 档 取 正确 的 值 


truststoreFile 用 来 验证 客户 证 书 的 TrustStore 文 件 


truststorePass _| 访问 TrustStore 使 用 的 密码 。 默 认 值 是 keystorePass 
如 果 使 用 一 个 不 同 于 正在 使 用 的 KeyStore 的 TrustStore 格 式 , 加 入 该 属性 。 有 效 值 是 JKS 
和 PKCS12 


truststoreType 


3. 验证 SSL 配置 的 正确 性 

按照 上 述 步骤 配置 好 后 ， 可 以 按照 如 下 步骤 验证 SSL 配置 的 正确 性 。 

(1) 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : https://localhost:8443， 可 以 看 到 
浏览 器 弹出 安全 警报 窗口 ， ee 15.6 所 示 。 

安全 警报 提示 : 您 与 该 站 点 交换 的 信息 不 会 被 其 他 人 查看 或 更 改 ， 但 该 站 点 的 安全 证 
书 有 问题 。 也 就 是 说 ， ee 了 安全 证 书 ， 如 果 和 这 个 网 站 通信 ， 通 信 数 据 会 被 加 密 
后 在 网 络 上 传播 是 不 会 被 其 他 人 看 到 或 修改 的 ; 另 一 方面 ， 就 如 上 面 介绍 的 那样 ， 这 个 网 
站 的 安全 证 书 不 是 权威 机 构 颁 发 的 ， 不 能 确认 对 方 的 身份 到 底 是 不 是 与 安全 证 书 中 的 信息 

一 致 。 也 可 以 这 样 理解 ， 该 服务 器 向 客户 发 送 了 一 个 “A”， 使 用 了 这 个 安全 证 书 可 以 保证 

这 个 信息 不 会 被 更 改 也 不 会 被 其 他 人 看 到 ， 但 却 无 法 保证 这 个 信息 “A” 是 否 会 对 客户 构成 
伤害 。 

(2) 单 击 【 查 看 证 书 】 按 钮 ， 可 以 看 到 证 书 的 版 本 、 颁 发 者 、 有 效 期 等 相关 信息 ， 如 
图 15.7 所 示 。 

这 些 信息 都 是 使 用 keytool 生成 时 输入 的 ， 可 以 看 到 这 个 安全 证 书 的 颁发 者 和 接受 证 书 
的 人 是 同一 个 人 ， 不 具有 权威 性 。 

(3) 在 安全 警报 对 话 框 中 单 击 【 是 】 按 钮 ， 就 会 继续 与 Tomcat 通信 ， 浏 览 器 显示 页 
面 如 图 15.8 所 示 。 

它 和 使 用 HTTP 显示 是 一 样 的 。 

(4) 在 【安全 警报 】 对 话 框 中 单 击 【 和 否 】 按 钮 ， 将 结束 与 Tomcat 的 通信 。 显 示 错 误 
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If you're seeing this page via a web browser, it means you've 
setup Tomcat successfully. Congratulations! 


As you may have guecsed by now thisisthe dofauk Tomcat home page, 
上 can be found on the localfllesystam at 


SCATALINA_HOME/ webapps/ROOT/index., jsp 


Where "FCATALINA_HOME" is the root of the Tomcat installation 


ENE 


L A 


图 15.8 ”安全 证 书 被 认可 


15.3 小 结 


JSP 技术 在 Web 应 用 的 开发 中 得 到 了 广泛 的 应 用 ,同时 Web 应 用 安全 的 问题 也 在 挑战 
JSP 技术 ， 而 JSP 技术 依托 Java 技术 的 良好 安全 性 ， 所 开发 的 Web 应 用 也 可 以 具有 较 好 的 
安全 性 ， 但 不 同 的 Web 服务 器 和 JSP 容器 所 提供 的 安全 机 制 有 所 不 同 ， 在 具体 使 用 某 个 服 
务 器 时 可 以 参考 其 相关 文档 。 
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第 16 章 Tomcat 容器 的 JSP 特色 应 用 


Tomcat 是 Servlet 规范 的 标准 实现 ， 同 时 ， 它 也 提供 了 很 多 有 特色 的 技术 ， 如 Tomcat 
阀 、 安 全 域 以 及 Tomcat 实现 的 JNDI 等 。 本 章 将 对 这 些 技术 作 简 单 介绍 。 


16.1 使 用 Tomcat 阀 


Tomcat 阀 可 以 对 HTTP 请 求 进行 预 处 理 完成 一 些 监 测 和 管理 功能 ， 它 的 工作 过 程 类 似 
于 Servlet 过 滤器 ， 是 Tomcat 专 有 的 特性 ， 其 他 Servlet 和 JSP 容器 不 支持 此 特性 。 下 面 介 
绍 各 种 Tomcat 阀 的 功能 和 使 用 方法 。 

所 有 的 Tomcat 阀 都 实现 了 org.apache.catalina.Valve 接口 或 者 继承 了 org.apache.catalina. 
valves.ValveBase 类 。Tomcat 阀 可 以 分 为 4 类 : 

口 客户 访问 日 志 阀 。 

口 远程 地 址 过 滤器 阀 。 

口 远程 主机 过 滤器 阀 。 

口 客户 请 求 记录 阀 。 

它们 可 以 被 加 入 到 Engine、Host 和 Context 元 素 中 。 处 在 不 同 的 元 素 中 ， 阀 的 作用 范 
围 是 不 一 样 的 。 加 入 Engine 元 素 的 Tomcat 阀 可 以 预 处 理 该 Engine 接收 到 的 所 有 HTTP 请 
求 ; 加 入 到 Host 中 的 Tomcat 阀 可 以 预 处 理 该 Host 接收 到 的 所 有 HTTP 请 求 。 

配置 Tomcat 阀 是 很 简单 的 ， 只 需要 在 Tomcat 配置 文件 server.xml 中 加 入 <Value> 元 素 
就 可 以 了 。 具 体形 式 为 : 

<Valve className=".." ...... /> 


其 中 ， 就 像 className 一 样 ， 每 个 Tomcat 阀 都 有 很 多 属性 可 以 设置 ， 不 同 的 闪 有 不 同 
的 属性 。 下 面 就 一 一 介绍 各 种 Tomcat 阀 的 相关 属性 和 使 用 方法 。 


16.1.1 ”客户 访问 日 志 瞩 


客户 访问 日 志 阀 (Access Log Valve) 能 够 把 客户 的 请 求 信息 保存 到 日 志文 件 中 ， 这 与 
标准 服务 器 创建 的 日 志 格 式 是 一 样 的 。 这 些 日 志 可 以 被 标准 日 志 工具 分 析 ， 并 对 客户 点 击 、 
用 户 活动 会 话 等 进行 统计 。 它 的 很 多 配置 和 特性 跟 File Logger 是 相同 的 ， 例 如 每 晚 在 零点 
时 自动 回 滚 等 。 客户 访问 日 志 阀 可 以 和 Catalina 的 任何 容器 关联 , 可 以 记 下 容器 处 理 的 所 有 
请 求 。 客 户 访 问 日 志 阀 支持 的 配置 属性 如 表 16.1 所 示 。 
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表 16.1 客户 访问 日 志 阀 支持 的 配置 属性 


属 性 描述 
className 指定 阀 的 Java 实 现 类 ， 这 里 应 该 为 org.apache.catalina.valves.AccessLogValve 


] 志 存放 的 目录 ， 可 以 是 相对 路 径 也 可 以 是 绝对 路 径 ， 指 定 相 对 路 径 时 是 相对 
<TOMCAT HOME>， 默 认 值 是 logs 

pattern ] 志 的 格式 和 内 容 ， 默 认 是 common 

1 志 的 前 级 名 ， 被 加 在 日 志文 件 的 开头 ， 默 认 是 access_log， 如 果 不 要 前 级 ， 要 指定 一 
ee 个 长 度 为 0 的 字符 串 

resolveHosts 如 果 设 为 tue， 把 IP 地 址 转化 为 主机 名 存 到 日 志 ， 否 则 直接 记录 IP 地 址 


directory 


suffix 1 志 名 的 扩展 名 ， 默 认 是 “” 
rotatable 决定 日 志文 件 是 否 可 旋转 ， 默 认为 true 
condition 条 件 日 志 ， 如 果 设 置 ， 只 有 在 ServletRequest.getAttribute() 为 空 时 记录 日 志 


fileDateFormat | 自 定义 日 志文 件 名 中 的 日 期 格式 


pattern 属性 由 字符 串 和 带 有 “%” 的 pattern 标志 符 前 级 结合 决定 当前 请 求 和 响应 信息 
的 格式 和 内 容 。 它 支持 如 下 的 pattern 码 : 
%a: 远程 主机 地 址 。 
%A: 本 地 IP 地 址 。 
%b: 发 送 的 字 节 数 ， 不 包括 HTTP Header， 如 果 为 零 记录 为 “一 ”。 
%B: 发 送 的 字 节 数 ， 不 包括 HTTP Header。 
%h: 远程 主机 名 如果 属性 resolveHosts 设 为 false 就 是 IP 地 址 〉。 
%H: 请 求 使 用 的 协议 。 
%1: 远程 逻辑 用 户 名 (总 是 返回 '-') 。 
%m: 请 求 使 用 的 方法 (GET、POST 等 ) 。 
%p: 接受 这 个 请 求 的 本 地 端口 。 
%q: 请 求 中 的 查询 字符 串 〈 如 果 存 在 以 ? 开头 ) 。 
%r: 这 个 请 求 的 第 一 行 (请求 的 方法 和 请 求 的 URI) 。 
%s: HTTP 响应 的 状态 码 。 
%S: 用 户 会 话 ID。 
%t: 日 期 和 时 间 ， 使 用 Common Log 的 格式 。 
%u: 经 过 安全 认证 的 远程 用 户 名 ， 不 存在 时 为 '-'。 
%U: 请 求 的 URL 路 径 。 
%v: 本 地 服务 器 名 。 
%D: 处 理 请 求 花 费 的 时 间 〈 以 毫秒 为 单位 ) 。 
%T: 处 理 请 求 花 费 的 时 间 〈 以 秒 为 单位 ) 。 
它 也 支持 记录 ServletRequest 中 的 一 些 信息 ,例如 Cookie、 请 求 头 和 Session 等 。pattern 
属性 的 默认 值 是 common，common 与 %h %1 %u %t "%r" %s %b 是 等 同 的 。 
在 Tomcat 的 server.xml 中 的 <Hos 位 元素 中 加 入 如 下 元 素 : 


<Valve className="org.apache.catalina.valves.AccessLogValve" 


DoOoOoOoOoOooooooooOooOooOooOoOoOOOoO DO 


口 
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directory="logs” prefix="localhost access log." suffix=".txt" pattern= "common" 
resolveHosts="false"/> 
pattern 使 用 了 默认 值 common， 重 启 Tomcat 后 ， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : 
http://localhost:8080/admin 并 登录 ， 然 后 查看 logs 目录 下 生成 一 个 localhost access_log. 
2005-08-14.txt 文件 。 文 件 内 容 如 下 : 
127.0.0.1 - - [14/Aug/2005:15:29:33 +0800] "GET /admin/ HTTP/1.1" 200 2578 
127.0.0.1 - - [14/Aug/2005:15:29:39 +0800] "POST /admin/} security check HTTP/1.1" 302 - 
127.0.0.1 - admin [14/Aug/2005:15:29:39 +0800] "GET /admin/ HTTP/1.1" 302 - 
127.0.0.1 - admin [14/Aug/2005:15:29:39 +0800] "GET /admin/frameset.jsp HTTP/1.1" 200 946 
127.0.0.1 - admin [14/Aug/2005:15:29:39 +0800] "GET /admin/blank.jsp HTTP/1.1" 200 579 
127.0.0.1 - admin [14/Aug/2005:15:29:39 +0800] "GET /admin/banner.jsp HTTP/1.1" 200 1996 
127.0.0.1 - admin [14/Aug/2005:15:29:41 +0800] "GET /admin/setUpTree.do HTTP/1.1" 200 8060 
在 这 里 使 用 了 pattern 的 默认 值 common， 通 过 分 析 最 后 一 条 日 志 记 录 ， 看 看 它 是 如 何 
和 %h %1 %u %t "%r" %s %b 对 应 起 来 的 。 
%h: 远程 主机 名 为 127.0.0.1。 
%1: 远程 逻辑 用 户 名 为 -。 
%u: 经 过 安全 认证 的 远程 用 户 名 为 admin。 
%t: 日 期 和 时 间 是 [14/Aug/2005:15:29:41 +0800]。 
"%r": 客户 请 求 的 第 一 行 ， 放 在 引号 内 为 "GET /admin/setUpTree.do HTTP/1.1"。 
%s: 服务 器 响应 代码 为 200。 
%b: 发 送 的 字 节 数 为 8060。 


日 日 日 日 口 日 日 


16.1.2 ”远程 地 址 过 滤器 


远程 地 址 过 滤器 (Remote Address Filter) 允许 把 客户 的 IP 地 址 同一 个 或 多 个 正则 表达 
式 相 比较 ,从 而 决定 是 否 为 该 客户 提供 服务 。 远 程 地 址 过 滤器 可 以 和 Catalina 的 任何 容器 关 
联 ， 而 且 在 请 求 被 处 理 之 前 它 必须 接受 任何 请 求 。 

正则 表达 式 与 普通 的 通配符 匹配 是 不 相同 的 。 具 体 关 于 正则 表达 式 的 相关 问题 可 以 参 
考 相关 文档 。 远 程 地 址 过 滤器 支持 的 配置 属性 介绍 如 表 16.2 所 示 。 


表 16.2 ”远程 地 址 过 滤器 支持 的 配置 属性 


属 性 描述 

className “| 指定 阀 的 Java 实 现 类 ， 这 里 应 该 为 org.apache.catalina.valves.RemoteAddrValve 

允许 访问 的 客户 人 PP 地址 正则 表达 式 列表 ， 用 运 号 分 隔 。 如 果 这 个 属性 被 设置 , 只 有 匹配 
的 地 址 才 允 许 访问 ， 如 果 不 被 设置 ， 只 要 该 地 址 不 在 拒绝 列表 中 就 允许 访问 

den 拒绝 访问 的 客户 耳 地 址 正则 表达 式 列表 ， 用 逗号 分 隔 


在 server.xml 中 的 <Host> 元 素 中 加 入 如 下 元 素 : 


<Valve className="org.apache.catalina.valves.AccessLogValve" 
allow="127.0.0.” deny ="222.”/> 
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这 样 设置 并 重新 启动 Tomcat 后 , 以 222 开头 的 卫 地 址 将 不 被 允许 访问 ,并 且 只 有 127.0.0 
开头 的 IP 地 址 才 允 许 访问 ， 也 就 是 自己 能 够 访问 。 


16.1.3 ”远程 主机 过 滤器 


远程 主机 过 滤器 (Remote Host Filter) 和 远程 地 址 过 滤器 很 相似 。 只 不 过 远程 主机 过 滤 
器 根据 远程 客户 的 主机 名 来 决定 是 否 响 应 客户 的 请 求 ， 而 不 是 客户 的 IP 地址 。 在 远程 主机 
过 滤器 中 ， 事 先 保存 了 一 个 允许 访问 的 客户 主机 名 列表 和 一 个 拒绝 服务 的 客户 主机 名 列表 。 
如 果 客 户 的 主机 名 在 拒绝 列表 中 ， 则 这 个 客户 的 请 求 不 会 被 Tomcat 响应 ; 如 果 客 户 的 主机 
名 在 允许 访问 的 列表 中 ， 那 么 这 个 客户 的 请 求 就 会 被 Tomcat 响应 。 远 程 主机 过 滤器 支持 的 
配置 属性 如 表 16.3 所 示 。 


表 16.3 ”远程 主机 过 滤器 支持 的 配置 属性 


描述 
指定 阀 的 Java 实 现 类 ， 这 里 应 该 为 org.apache.catalina.valves.RemoteHostValve 
允许 访问 的 客户 主机 名 正则 表达 式 列表 ， 用 去 号 分 隔 。 如 果 这 个 属性 被 设置 ， 只 有 匹配 的 
地 址 才 允 许 访问 ;如 果 不 被 设置 ， 只 要 该 地 址 不 在 拒绝 列表 中 就 允许 访问 
拒绝 访问 的 客户 趾 地 址 正则 表达 式 列 表 ， 用 去 号 分 隔 


在 server.xml 中 的 <Host> 元 素 中 加 入 如 下 元 素 : 


<Valve className="org.apache.catalina.valves.AccessLogValve" 
allow="ms*"/> 


这 样 设置 并 重新 启动 Tomcat 后 ， 只 有 以 ms 开头 的 主机 名 才 允 许 访问 。 


16.1.4 ”客户 请 求 记录 器 


客户 请 求 记录 器 (Request Dumper) 是 一 个 非常 有 用 的 工具 ， 它 可 以 调试 与 客户 应 用 程 
序 的 交互 。 被 配置 后 ， 会 把 和 它 相 关 的 客户 请 求 信息 的 详细 细节 保存 到 日 志文 件 中 。 它 使 
用 的 日 志文 件 是 在 <Logger> 中 配置 的 。 

全 注意 ; 使 用 客户 请 求 记录 器 是 有 副作用 的 ， 这 个 闪 的 输出 包括 请 求 中 的 任何 参数 。 这 些 
参数 将 会 按照 默认 平台 的 编码 标准 解码 。 在 应 用 程序 中 的 后 续 任 何 对 方法 
request.setCharacterEncoding() 的 调用 都 不 起 作用 

(1) 客户 请 求 记录 器 只 有 一 个 属性 需要 设置 一 一 lassName， 它 必须 被 设置 为 org.apache. 
catalina.Valves.RequestDumperValve。 
(2) 要 使 用 客户 请 求 记录 器 ， 必 须 保 证 在 Tomcat 的 配置 文件 server.xml 中 已 经 配置 

了 一 个 <Logger> 元 素 。 如 果 没 有 配置 ， 可 以 按照 如 下 配置 : 

<Logger className="org.apache.catalina.logger.FileLogger" 


directory="logs"” prefix="localhost log.” suffix=".txt" 
timestamp="true"/> 
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(3) 配置 好 <Logger> 元 素 后 ， 在 <Host> 元 素 中 加 入 如 下 元 素 : 


<Valve className="org.apache.catalina.valves.Request DumperValve"/> 


(4) 重新 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 地 址 http://localhost:8080/admin/ 后 ， 查 

看 刚刚 配置 好 的 日 志文 件 。 可 以 看 到 文件 内 容 如 下 : 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: REQUEST URI =/admin/ 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: authType=null 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: characterEncoding=null 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: contentLength=-1 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: contentType=null 

2005-08-14 16:40:37 RequestDumperValve[Catalinal]: contextPath=/admin 


2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

contextPath =/admin 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 
cookie=JSESSIONID=835C7E753B5293F4D9CA31DAEE2269CE 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

header=accept=image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-excel, 
application/vnd.ms-powerpoint, application/msword, application/x-shockwave-flash, */* 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: 
header=accept-language=zh-cn 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

header=accept-encoding=gzip, deflate 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

header=user-agent=Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1) 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

header=host=localhost:8080 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 
header=connection=Keep-Alive 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 
header=cookie=JSESSIONID=835C7E753B5293F4D9CA31DAEE2269CE 


2005-08-14 16:40:37 RequestDumperValve[Catalina]: locale=zh_CN 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: method=GET 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: pathlnfo=null 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: protocol=HTTP/1.1 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: queryString=null 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: remoteAddr=127.0.0.1 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: remoteHost=127.0.0.1 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: remoteUser=null 


2005-08-14 16:40:37 RequestDumperValve[Catalina]: 
requestedSessionld=835C7E753B5293F4D9CA31DAEE2269CE 


2005-08-14 16:40:37 RequestDumperValve[Catalina]: scheme=http 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: ServerName=localhost 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: serverPort=8080 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: servletPath=/index.jsp 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: isSecure=false 


2005-08-14 16:40:37 RequestDumperValve[Catalina]: 


2005-08-14 16:40:37 RequestDumperValve[Catalina]: authType=null 
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2005-08-14 16:40:37 RequestDumperValve[Catalina]: contentLength=-1 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

contentType=text/html;charset=utf-8 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 
cookie=JSESSIONID=8EA671C9AF6E6B522139653A4180F6F5; domain=null; path=/admin 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

header=Pragma=No-cache 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

header=Cache-Control=no-cache 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: 

header=Expires=Thu, 01 Jan 1970 08:00:00 CST 

2005-08-14 16:40:37 RequestDumperValve[Catalina]: header=Set-Cookie=JSESSIONID=8EA671 
C9AF6E6B522139653A4180F6F5; Path=/admin 


2005-08-14 16:40:37 RequestDumperValve[Catalina]: message=null 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: remoteUser=null 
2005-08-14 16:40:37 RequestDumperValve[Catalina]: status=200 


2005-08-14 16:40:37 RequestDum 


rValve[Catalina]: 


16.1.5 “ 单 点 登录 阀 


当 开 发 者 希望 用 户 只 要 一 登录 与 本 虚拟 主机 相关 的 Web 应 用 程序 ， 用 户 就 可 以 被 同 
台 虚 拟 主机 上 的 所 有 Web 应 用 程序 识别 时 ， 可 以 使 用 单 点 登录 阀 (Single Sign On Valve) 。 
单 点 登录 阀 的 配置 属性 如 表 16.4 所 示 。 


表 16.4 单 点 登录 阀 支 持 的 配置 属性 
描述 
指定 阀 的 Java 实 现 类 ， 这 里 必须 为 org.apache.catalina.authenticator.SingleSignOn 
这 个 组 件 创造 的 调试 信息 的 级 别 ， 默 认为 0， 也 就 是 没有 任何 输出 
决定 每 个 请 求 需要 到 安全 Realm 中 进行 验证 ,如 果 为 tue,， 则 这 个 阀 用 缓存 的 信 
任 信息 重新 认证 。 默 认为 false 


属 性 


className 


requireReauthentication 


在 server.xml 中 配置 一 个 单 点 登录 阀 元 素 如 下 : 
<Valve className="org.apache.catalina.authenticator.SingleSignOn" 
debug="0"/> 
这 样 就 可 以 实现 单 点 登录 的 功能 了 。 不 过 使 用 单 点 登录 还 有 一 些 限 制 。 如 下 : 
口 Valve 必须 被 配置 和 嵌 套 在 相同 的 Host 元 素 中 , 并 且 所 有 需要 进行 单 点 验证 的 Web 
应 用 (必须 通过 Context 元 素 定 义 ) 都 位 于 该 Host 下 。 
口 包括 共享 用 户 信息 的 Realm 必须 被 设置 在 同一 级 Host 中 或 者 嵌 套 之 外 。 
口 不 能 被 Context 中 的 Realm 履 盖 。 
口 使 用 单 点 登录 的 Web 应 用 最 好 使 用 一 个 Tomcat 内置 的 验证 方式 (被 定义 在 web.xml 
中 ) ， 这 比 自 定义 的 验证 方式 好 。Tomcat 内 置 的 验证 方式 包括 BASIC、DIGEST、 
FORM 和 CLIENT-CERT。 
口 如 果 使 用 单 点 登录 ， 还 希望 集成 一 个 第 三 方 的 Web 应 用 到 应 用 中 来 ， 并 且 这 个 新 
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的 Web 应 用 使 用 它 自 己 的 验证 方式 ， 而 不 使 用 容器 管理 安全 ， 那 请 求 第 三 方 应 用 
时 还 需要 重新 登录 。 单 点 登录 需要 使 用 Cookie。 


16.2 使 用 基于 JNDI 的 应 用 程序 开发 (介绍 Tomcat 的 
JNDI 资源 ) 


JNDI 是 The Java Naming and Directory Interface 的 简写 。 使 用 JNDI 可 以 访问 命名 和 日 
录 服 务 。 实 际 是 一 组 在 Java 应 用 中 访问 命名 和 目录 服务 的 API。 命 名 服务 将 名 称 和 对 象 联 
系 起 来 ， 使 得 开发 者 可 以 用 名 称 访 问 对 象 。 

Tomcat 5 为 每 一 个 运行 其 中 的 Web 应 用 程序 提供 了 一 个 JNDI InitialContext 的 实例 , 它 
提供 服务 的 方式 和 J2EE 服务 器 提供 服务 的 方式 是 一 样 的 。J2EE 标准 在 Web 应 用 的 
/WEB-INF/web.xml 文件 中 提供 了 一 些 标准 元 素 用 于 引用 资源 ， 被 引用 的 资源 必须 在 服务 器 
应 用 的 配置 文件 中 配置 指定 。 

对 于 Tomcat 5 来 说 ， 这 些 资源 必须 配置 在 <Context> 元 素 或 者 <Server> 元 素 下 的 
<DefaultContext> 元 素 中 。 

如 果 配 置 在 <Context> 元 素 中 , 这 个 资源 只 可 以 在 具体 某 个 应 用 的 web.xml 文件 中 设置 。 
如 果 配 置 在 <DefaultContext> 元 素 中 ， 就 必须 修改 <TOMCAT_HOME>\conf\server.xml 文件 。 

Tomcat 5 为 整个 服务 器 保留 了 一 个 全 局 资源 的 命名 空间 ， 它 们 可 以 在 <TOMCAT_ 
HOME>\conf\server.xml 文件 中 配置 ， 然 后 使 用 <ResourceLink> 让 各 个 应 用 程序 可 以 访问 这 
个 资源 。 

在 这 些 元 素 中 定义 的 资源 可 以 被 具体 某 个 应 用 的 配置 文件 /WEB-INF/web.xml 中 的 某 些 
元 素 引 用 。 这 些 元 素 可 以 是 如 下 几 项 : 

口 <env-entry>: 环境 入 口 ， 设 置 应 用 程序 如 何 操作 。 

口 <resource-re 仔 : 资源 参数 ， 一 般 是 数据 库 驱 动 程序 、Java Mail Sessions、 自 定义 类 

王 三 等 s 
口 <resource-env-ref>: 在 Servlet 2.4 中 用 来 简化 设置 不 需 认 证 信息 的 资源 ， 如 环境 参 
数 、resource-ref 变量 。 

InitialContext 在 应 用 程序 初始 化 发 布 时 被 配置 好 ， 之 后 应 用 程序 可 以 一 直 使 用 这 个 对 
象 。 所 有 资源 的 入 口 都 在 java:comp/env 这 个 JNDI 命名 空间 下 。 对 于 JDBC DataSource 来 
说 ， 可 以 使 用 如 下 代码 : 

// 获得 环境 的 命名 上 下 文 


Context initCtx = new InitialContext(); 
Context envCtx = (Context) initCtx.lookup("java:comp/env"); 


发 


/寻找 需要 的 DataSource 
DataSource ds = (DataSource) 
envCtx.lookup("jdbc/EmployeeDB"); 


// 从 连接 池 中 定位 并 获取 一 个 连接 
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Connection conn = ds.getConnection(); 

使 用 这 个 连接 做 访问 数据 库 的 操作 

conn.close(); 

任何 可 用 JNDI 资源 都 需要 使 用 在 <Context> 或 者 <DefaultContext> 下 的 元 素 进行 配置 。 
这 些 元 素 如 下 : 

口 <Environment>: 设置 一 个 可 变 的 JNDI InitialContext 入 口 的 名 字 和 值 (同上 面 所 说 

的 <env-entry> 等 价 ) 。 
口 <Resource>: 设置 应 用 程序 可 用 资源 的 名 字 和 类 型 〈 同 上 面 所 说 的 <resource-re 他 等 
和 价 六 去 

口 <ResourceParams>: 设置 Java 资源 类 工厂 的 名 称 或 将 用 的 JavaBeans 属性 。 

口 <ResourceLink>: 给 全 局 JNDI 环境 (JNDI Context) 添加 一 个 链接 。 

Tomcat 包含 了 一 些 标准 资源 工厂 以 用 于 为 Web 应 用 程序 提供 服务 。 要 使 用 这 些 服务 是 
需要 修改 一 些 配置 文件 〈 像 上 面 介 绍 的 那些 一 样 ) 。 除 了 使 用 Tomcat 提供 的 资源 工厂 外 ， 
也 可 以 自己 设计 资源 工厂 。 下 面 就 介绍 如 何 使 用 Tomcat 的 标准 资源 工厂 以 及 如 何 设 计 安装 
自己 定制 的 资源 工厂 。 


16.2.1 使 用 通用 JavaBeans 资源 


这 个 资源 工厂 可 以 创建 任何 符合 标准 JavaBeans 命名 约定 的 Java 类 对 象 ( 例 如 没有 参 
数 的 构造 器 、 每 个 属性 都 有 对 应 的 setter 和 getter 方法 ) ， 每 次 使 用 lookup() 方 法 查找 一 个 
对 象 时 ， 这 个 资源 工厂 都 会 创建 一 个 Bean 实例 。 

下 面 就 介绍 一 个 简单 使 用 普通 JavaBeans 资源 的 例子 。 在 这 个 例子 中 ,创建 了 一 个 保存 
用 户 信息 的 JavaBeans， 然 后 从 JSP 页 面 中 访问 使 用 这 个 Bean。 

1. 创建 JavaBeans 类 

JavaBeans 资源 每 次 被 搜索 时 ，JavaBeans 类 都 会 被 实例 化 一 次 。 下 面 创建 了 一 个 cn.ac. 
ict.UserInfo 的 JavaBeans。 如 下 : 


package cn.ac.ict; 


public class Userlnfof 

private String username ="guest"; 

private String password ="anonymous"; 

// 下 面 是 username 属性 的 设置 和 获取 方法 

public void setUsername (String user){ 
Username = user; 


} 


public String getUsername(){ 
return this.username; 
bE 
// 下 面 是 password 属性 的 设置 和 获取 方法 
public void setPassword(String pass\{ 
this.password = pass; 
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} 


public String getPassword(){ 
return this.password; 


bE 


} 


这 个 JavaBeans 是 非常 简单 的 ， 有 两 个 属性 username 和 password 以 及 相应 的 setter 方 
法 和 getter 方法 。 

2. 配置 Tomcat 资源 工厂 

要 配置 Tomcat 资源 工厂 ， 就 需要 修改 <TOMCAT_HOME>/conf/server.xml 文件 或 者 
<TOMCAT_HOME>/conf/Catalina/localhost/ 目 录 下 对 应 Web 应 用 的 Context 名 字 的 XML 文件。 

资源 的 声明 可 以 被 放 在 <Context>、<Hos 人 > 或 <Engine> 元 素 下 。 如 果 放 在 <Context> 下 ， 
这 个 资源 工厂 可 以 被 这 个 应 用 使 用 ， 而 放 在 <Host> 或 <Engine> 元 素 下 ， 就 使 得 这 个 资源 工 
三 有 了 更 大 的 有 效 范围 ， 分 别 在 本 Host 和 本 Engine 中 有 效 。 

如 果 修 改 <TOMCAT_HOME>/conf/Catalina/localhost/ 目 录 下 对 应 Web 应 用 的 Context 名 
称 的 XML 文件 ， 则 只 能 使 这 个 资源 工厂 在 本 Web 应 用 范围 内 有 效 。 

下 面 以 <TOMCAT_HOME>/conf/Catalina/localhost/ 目 录 下 对 应 Web 应 用 的 Context 名 称 的 
XML 文件 为 例 添 加 资源 工厂 ， 假 定 本 Web 应 用 的 Context 名 为 INDI， 则 在 <TOMCAT_ 
HOME>/conf/Catalina/localhost/JNDI.xml 文件 的 <Contex 人 元 素 中 添加 如 下 语句 : 

< 定义 了 一 个 资源 -> 


<Resource name="bean/userinfo" auth="Container" 
type="cn.ac.ictUserlnfo"/> 


<!--- 下 面 为 名 为 "bean/userinfo" 的 资源 指定 需要 使 用 的 参数 --> 
<ResourceParams name="bean/userinfo"> 
<parameter> 
<name>factory</name> 
<value>org.apache.naming.factory.BeanFactory</value> 
</parameter> 
<parameter> 
<name>username</name> 
<value>rambler</value> 
</parameter> 
</ResourceParams> 


在 上 面 的 语句 中 首先 使 用 <Resource> 定 义 了 一 个 资源 ， 名 称 为 bean/userinfo， 由 
Container 授权 ， 类 型 为 cn.ac.ict.UserInfo。 下 面 的 <ResourceParams> 为 名 为 bean/userinfo 的 
资源 指定 了 参数 , 其 中 factory 是 一 个 必需 的 参数 ,用 于 指定 实例 化 这 个 Bean 所 需要 的 工厂 。 
其 他 的 参数 可 以 根据 具体 Bean 的 不 同 来 设置 。 这 里 设置 了 username 属性 的 值 为 rambler。 

外 注意 : 这 个 资源 的 名 字 bean/userinfo 是 应 用 程序 引用 资源 时 使 用 的 惟一 性 标志 。 
3. 声明 资源 引用 
为 了 在 某 个 Web 应 用 中 使 用 在 容器 组 件 中 定义 的 (例如 上 面 的 资源 定义 在 Context 组 
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件 中 ) 资源 ， 还 需要 在 Web 应 用 的 web.xml 文件 中 声明 引用 的 资源 。 修 改 JNDI 应 用 下 的 
/WEB-INF/web.xml 文件 ， 在 <Contex 亿 元素 中 添加 如 下 语句 : 


<resource-env-ref> 
<description> 
Object factory for Userlnfo instances. 
</description> 
<!--- ”指定 了 资源 的 名 字 一 -> 
<resource-env-ref-name> 
bean/userinfo 
</resource-env-ref-name> 
<!--- ”指定 了 资源 的 类 型 一 -> 
<resource-env-ref-type> 
cn.ac.ict.Userlnfo 
</resource-env-ref-type> 
</resource-env-ref> 


其 中 ，<resource-env-ref-name> 元 素 确 定 了 使 用 的 资源 名 称 〈 在 TomcatConfig.xml 文件 
中 定义 的 bean/userinfo) ， 然 后 使 用 元 素 <resource-env-ref-type> 指 定 了 资源 的 类 型 为 
cn.ac.ict.UserInfo 。 

4. 使 用 JavaBeans 资源 

经 过 上 面 的 准备 工作 ， 需 要 使 用 的 JavaBeans 资源 已 经 被 配置 好 了 ， 这 样 就 可 以 在 JSP 
页 面 中 访问 这 个 JavaBeans 资源 了 。 下 面 是 一 个 测试 使 用 这 个 JavaBeans 资源 的 一 个 JSP 文 
件 的 源 代 码 〈 命 名 为 javabeansource.jsp) : 

<%@ page import="javax.naming.*,cn.ac.ict.”%> 

<html> 

<head><title>Generic JavaBean Resources Test</title></head> 


<body> 
<h2>Generic JavaBean Resources</h2> 


<% 

// 获 取 上 下 文 对 象 

Context initCtx = new InitialContext(); 

Context envCtx = (Context) initCtx.lookup("java:comp/env"); 

/寻找 需要 实例 化 的 资源 对 象 

Userlnfo bean = (Userlnfo) envCtx.lookup("bean/userinfo"); 

// 输 出 资源 的 信息 

out.printin("Username = " + bean.getUsername() + ", password = "+ 
bean.getPassword()); 


%> 

</body> 

</html> 

上 述 代 码 通过 Context initCtx = new InitialContext(); 获 得 了 一 个 关于 本 JSP 页 面 应 用 的 
上 下 文 (Context) 对 象 initCtx, 然后 通过 这 个 对 象 查 找 已 定义 好 的 资源 bean/userinfo， 获 得 
一 个 JavaBeans 资源 。 


可 以 看 到 ，JSP 代码 的 输出 部 分 输出 了 Bean 中 保存 的 用 户 名 和 密码 。 在 浏览 器 地 址 栏 
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中 输入 地 址 http://localhost:8080/JNDljavabeansource. 
jsp 便 可 看 到 页 面 显示 如 图 16.1 所 示 。 

其 中 的 用 户 名 显示 为 rambler， 也 就 是 在 配置 资源 mr 
工厂 时 使 用 <ResourceParams> 元 素 设 定 的 , 而 密码 则 没 ee 
有 重 设 值 ， 所 以 输出 默认 值 anonymous。 ee 


同 寺 阿 [ [EL 


16.2.2 ”使 用 Java Mail Sessions 资源 图 16.1 访问 JavaBeans 资源 


在 很 多 Web 应 用 中 , 发 送 电子 邮件 是 系统 功能 要 求 的 一 部 分 。Java Mail API 使 得 这 个 过 程 
简单 化 了 ， 但 还 是 需要 很 多 的 配置 细节 。 如 果 写 在 程序 中 会 使 得 程序 变 得 复杂 和 不 易 维护 。 
Tomcat 5 中 提供 了 一 个 标准 资源 工厂 以 用 于 创建 javax.mail.Session 的 实例 ， 而 且 这 个 
实例 是 已 经 连接 到 SMTP 服务 器 的 。 这 样 就 可 以 使 应 用 程序 不 必 配 置 邮件 服务 器 的 细节 ， 
从 而 使 维护 变 得 容易 了 。 
使 用 Java Mail Sessions 的 基本 步骤 如 下 : 
(1) 配置 Tomcat 资源 工厂 。 
(2) 声明 资源 引用 。 
(3) 代码 实现 。 


16.2.3 ”使 用 JDBC Data Sources 


许多 Web 应 用 程序 都 需要 使 用 JDBC 驱动 程序 连接 数据 库 。 在 J2EE 平台 规范 中 ， 允 
许 实现 一 个 JDBC Data Sources (也 就 是 JDBC 的 数据 库 连接 池 ) ，Tomcat 5 对 这 个 实现 提 
供 了 很 好 的 支持 ， 使 得 Web 应 用 可 以 不 需要 修改 就 能 移植 到 其 他 的 平台 上 。 


县 注意 : Tomcat 5 默认 对 数据 源 的 支持 使 用 了 Jakarta Commons 子 项 目的 DBCP 数据 库 连 
接 池 ， 也 可 以 使 用 其 他 的 实现 技术 ， 只 是 需要 实现 javax.sql.DataSource 就 可 以 了 。 
在 Tomcat 5 中 配置 使 用 JDBC Data Sources 可 以 按照 如 下 步骤 进行 
(1) 安装 JDBC 驱动 程序 。 
(2) 配置 Tomcat 资源 工厂 。 
(3) 声明 资源 引用 。 
(4) 代码 实现 。 


16.3. a 结 


Tomcat 得 到 了 广泛 的 认可 ， 它 不 但 完全 实现 了 ServletJSP 的 最 新 标准 ， 而 且 还 提供 了 
很 多 优良 的 特性 。 本 章 只 介绍 了 有 代表 性 的 两 个 。 读 者 在 使 用 Tomcat 时 会 发 现 还 有 很 多 独 
有 的 特性 可 以 优化 Web 开发 。 当 然 其 他 的 Servlet 容器 也 有 自己 的 特性 ， 这 里 就 不 一 一 介绍 
了 。 读 者 可 以 参考 Tomcat 等 Servlet 容器 的 相关 文档 。 
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Hibernate 是 一 个 开放 源 代码 的 对 象 关 系 映射 框架 ， 它 对 JDBC 进行 了 非常 轻 量 级 的 对 
象 封 装 ， 使 得 Java 程序 员 可 以 随心 所 欲 地 使 用 对 象 编程 思维 来 操纵 数据 库 。Hibernate 可 以 
应 用 在 任何 使 用 JDBC 的 场合 ， 既 可 以 在 Java 的 客户 端 程序 实用 ， 也 可 以 在 ServleWJSP 的 
Web 应 用 中 使 用 , 最 具 革 命 意义 的 是 , Hibemate 可 以 在 应 用 EJB 的 J2EE 架构 中 取代 CMP， 
完成 数据 持久 化 的 重任 。 


17.1 快速 体验 JSP 结合 Hibernate 一 一 JSP 和 Hibernate 
结合 的 简单 例子 


17.1.1 ”Hibernate 简介 


Hibernate 是 一 个 面向 Java 环境 的 对 象 /关系 数据 库 映 射 工具 。 对 象 /关系 数据 库 映射 
(Object/Relational Mapping，ORM) 这 个 术语 表示 一 种 技术 ， 用 来 把 对 象 模 型 表示 的 对 象 

映射 到 基于 SQL 的 关系 模型 数据 结构 中 去 。 

Hibernate 不 仅 管理 Java 类 到 数据 库 表 的 映射 (包括 Java 数据 类 型 到 SQL 数据 类 型 
的 映射 ), 还 提供 数据 查询 和 获取 数据 的 方法 , 可 以 大 幅度 减少 开发 时 人 工 使 用 SQL 和 JDBC 
处 理 数据 的 时 间 。 

Hibernate 可 以 帮助 开发 者 消除 或 者 包装 那些 针对 特定 厂商 的 SQL 代码 ,并 且 帮 助 开 发 
者 把 结果 集 从 表格 式 的 表示 形式 转换 到 一 系列 的 对 象 去 ，Hibernate 使 用 数据 库 和 配置 信息 
为 应 用 程序 提供 持久 化 服务 以 及 持久 的 对 象 ) 。Hibernate 的 目标 是 对 于 开发 者 通常 的 数 
据 持 久 化 相关 的 编程 任务 解放 其 中 的 95%。 对 于 以 数据 为 中 心 的 程序 来 说 ， 它 们 往往 只 在 
数据 库 中 使 用 存储 过 程 来 实现 商业 逻辑 ，Hibernate 可 能 不 是 最 好 的 解决 方案 ; 对 于 那些 在 
基于 Java 的 中 间 层 应 用 中 , 实现 面向 对 象 的 业务 模型 和 商业 逻辑 的 应 用 中 Hibernate 是 最 有 
用 的 。Hibernate 体系 结构 如 图 17.1 所 示 。 

Hibernate 本 身 是 个 独立 的 框架 , 它 不 需要 任何 Web Server 或 Application Server 的 支持 。 
下 面 详细 看 一 下 Hibernate 运行 时 体系 结构 。 由 于 Hibernate 非常 灵活 , 且 支 持 数 种 应 用 方案 ， 
所 以 这 里 只 描述 两 种 极端 的 情况 。“ 轻 型 的 体系 结构 方案 , 要 求 应 用 程序 提供 自己 的 JDBC 
连接 并 管理 自己 的 事务 。 这 种 方案 使 用 了 Hibemate API 的 最 小 子 集 ， 此 时 ，Hibernate 在 应 
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程序 中 的 作用 如 图 17.2 所 示 。 


L 


应 用 程序 


持久 化 对 象 


Hibernate 


hibernate.cfa.xml 


hibernate.properties 


数据 库 


图 17.1 Hibernate 体系 结构 


瞬 态 对 象 〔Transient 应 用 程序 
Object) 
持久 化 对 象 
本 | 
SessionFactory Session JDBC JNDI JTA 
数据 库 
图 17.2 轻型 Hibemate 运行 体系 结构 
“全 面 解 决 ”的 体系 结构 方案 将 应 用 层 
从 底层 的 JDBC/JTA API 中 抽象 出 来 ， 而 让 sr 
Hibemate 来 处 理 这 些 细节 ， 如 图 17.3 所 示 。 i 
图 173 中 各 个 对 象 的 介绍 如 下 入 化 
口 SessionFactory (org.hibernate. Session sie Ee a 
Factory): 针对 单个 数据 库 映射 关 | | 
系 经 过 编译 后 的 内 存 镜像 ， 它 也 
是 线程 安全 的 (不 可 变 ) 。 它 是 INDI | JDBC | ITA | 
生成 Session 的 工厂 ， 本 身 要 用 到 
ConnectionProvider。 该 对 象 可 以 在 
进程 或 集群 的 级 别 上 ， 为 那些 事务 数据 库 


之 间 可 以 重用 的 数据 提供 可 选 的 二 


级 缓存 。 


图 17.3 “全 面 解决 ”的 体系 结构 


口 


口 
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Session(org.hibernate.Session): 表示 应 用 程序 与 持久 储存 层 之 间 交 互 操作 的 一 个 单 
线程 对 象 ， 此 对 象 生存 期 很 短 。 它 隐藏 了 JDBC 连接 ,也 是 Transaction 的 工厂 。 会 
持 有 一 个 针对 持久 化 对 象 的 必 选 (第 一 级 ) 缓存 ， 在 遍历 对 和 象 图 或 者 根据 持久 化 标 
识 查找 对 象 时 会 用 到 。 

持久 的 对 象 及 其 集合 : 带 有 持久 化 状态 的 、 具 有 业务 功能 的 单线 程 对 象 ， 此 对 象 生 
存 期 很 短 。 这 些 对 象 可 以 是 普通 的 JavaBeans 或 者 POJO (Plain Old Java Objects， 
就 是 POJOs, 有 时 也 称 作 Plain Ordinary Java Objects, 一 个 POJO 很 像 JavaBeans) ， 
比较 特殊 的 是 它们 只 与 一 个 〈 仅 仅 一 个 ) Session 相关 联 。 这 个 Session 被 关闭 的 同 
时 ， 这 些 对 象 也 会 脱离 持久 化 状态 ， 可 以 自由 地 被 应 用 程序 的 任何 层 使 用 例如 ， 
用 于 跟 表示 层 打 交道 的 数据 传输 对 象 Data Transfer Object) 。 

瞬 态 〈Transient) 以 及 脱 管 〈Detached) 的 对 象 及 其 集合 : 持久 类 的 没有 与 Session 
相关 联 的 实例 。 它 们 可 能 是 在 被 应 用 程序 实例 化 后 尚未 进行 持久 化 的 对 象 。 也 可 能 
是 因为 实例 化 它们 的 Session 已 经 被 关闭 而 脱离 持久 化 的 对 象 。 

事务 Transaction(org.hibernate.Transaction) (可 选 的 ) : 应 用 程序 用 来 指定 原子 操作 
单元 范围 的 对 象 ， 它 是 单线 程 的 ， 生 存 期 很 短 。 它 通过 抽象 将 应 用 从 底层 具体 的 
JDBC、JTA 以 及 CORBA 事务 隔离 开 。 某 些 情况 下 ， 一 个 Session 之 内 可 能 包含 多 
个 Transaction 对 象 。 尽 管 是 否 使 用 该 对 象 是 可 选 的 ， 但 事务 边界 的 开启 与 关闭 (无 
论 是 使 用 底层 的 API 还 是 使 用 Transaction 对 象 ) 是 必 不 可 少 的 。 
ConnectionProvider(org.hibernate.connection.ConnectionProvider) (可 选 的 ) : 生成 
JDBC 连接 的 工厂 (同时 也 起 到 连接 池 的 作用 ) 。 它 通过 抽象 将 应 用 从 底层 的 
Datasource 或 DriverManager 中 隔离 开 。 仅 供 开 发 者 扩展 /实现 用 ， 并 不 暴露 给 应 用 
程序 使 用 。 

TransactionFactory (org.hibernate.TransactionFactory) 〈 可 选 的 ) : 生成 Transaction 
对 象 实例 的 工厂 。 仅 供 开发 者 扩展 /实现 用 ， 并 不 暴露 给 应 用 程序 使 用 。 

扩展 接口 :Hibernate 提供 了 很 多 可 选 的 扩展 接口 ， 可 以 通过 实现 它们 来 定制 持久 
层 的 行为 。 


在 一 个 “轻型 ”的 体系 结构 中 ， 应 用 程序 可 能 绕 过 Transaction/TransactionFactory 以 及 
ConnectionProvider 等 API 直接 跟 JTA 或 JDBC 打交道 。 


17.1.2 ”配置 Hibernate 环境 


下 面 以 在 Apache Tomcat Servlet 容器 中 为 Web 应 用 程序 配置 使 用 Hibernate 3.0〈 使 用 
Tomcat 5.0 版 本 ) 为 例 ， 介 绍 一 个 简单 的 Hibemate 与 JSP 的 结合 应 用 。Hibernate 在 大 多 数 
主流 J2EE 应 用 服务 器 的 运行 环境 中 都 可 以 良好 地 工作 , 甚至 也 可 以 在 独立 Java 应 用 程序 中 
使 用 。 使 用 的 示例 数据 库 系 统 是 MySQL 4.1， 而 且 只 需要 修改 Hibemate SQL 语言 配置 与 连 
接 属性 ， 就 可 以 很 容易 地 支持 其 他 数据 库 了 。 

要 使 用 Hibemate 开发 Web 应 用 ， 首 先 要 到 其 官方 网 站 http://www.hibernate.org/ 下 载 


"308° 


JSP 网 络 开 发 技术 及 整合 应 用 


Hibernate 包 ， 在 本 实例 中 使 用 的 是 Hibemate 3.0， 把 hibernate-3.0.zip 解压 缩 后 ， 可 以 在 其 
解压 目录 下 看 到 一 个 hibernate3.jar 文件 ， 这 就 是 Hibernate 运行 需要 的 核心 包 ， 但 只 有 这 一 
个 包 是 不 够 的 ， 还 需要 lib 目录 下 的 其 他 包 的 支持 ， 要 使 用 Hibemate 就 需要 把 这 些 包 一 起 
复制 到 Web 应 用 的 WEB-INF\lib 目录 下 ， 但 这 些 包 并 不 都 是 必需 的 ， 根 据 具体 的 需要 可 以 
有 选择 地 使 用 ， 下 面 对 一 部 分 包 的 的 作用 作 一 下 简单 介绍 : 


口 


| 


口 
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antlr-2.7.5H3.jar〔 必 需 ) : Hibernate 使 用 ANTLR 来 产生 查询 分 析 器 ， 这 个 类 库 在 
运行 环境 下 时 也 是 必需 的 。 

cglib-2.1jar〈 必 需 ) : Hibernate 用 它 来 实现 PO 字 节 码 的 动态 生成 ， 非 常 核心 的 库 
必须 使 用 的 jar 包 。 

asmjar〈 必 需 ) : Hibernate 在 运行 时 使 用 这 个 代码 生成 库 增强 类 与 Java 反射 机 
制 联 合 使 用 ) 。 

commons-collections-2.1.1.jar( 必 需 ) : Apache Commons 包 中 的 一 个 ， 包 含 了 一 些 
Apache 开发 的 集合 类 ， 功 能 比 java.util* 强 大 。 必 须 使 用 的 jar 包 。 
commons-logging-1.0.4.jar (必需 ) : Apache Commons 包 中 的 一 个 ， 包 含 了 日 志 功 
能 ， 必 须 使 用 的 jar 包 。 这 个 包 本 身 包含 了 一 个 Simple Logger， 但 功能 很 弱 。 在 运 
行 时 它 会 先 在 CLASSPATH 中 找 Log4j， 如 果 有 ， 就 使 用 Log4j， 如 果 没 有 ， 就 找 
JDK1.4 带 的 java.util.logging， 如 果 还 找 不 到 就 使 用 Simple Logger。 

ehcache-1.1.jar (必需 ) : Hibernate 可 以 使 用 不 同 cache 缓存 工具 作为 二 级 缓存 。 
EHCache 是 默认 的 cache 缓存 工具 。 

dom4j.jar (必需 ) : dom4j 是 一 个 Java 的 XML API， 类 似 于 jdom， 用 来 读 写 XML 
文件 。dom4j 是 一 个 非常 优秀 的 Java XML API， 具 有 性 能 优异 、 功 能 强大 和 非常 易 
于 使 用 的 特点 ， 同 时 它 也 是 一 个 开放 源 代码 的 软件 ， 可 以 在 SourceForge 上 免费 下 
载 。Sun 的 JAXM 也 在 用 dom4j。 这 是 必须 使 用 的 jar 包 ，Hibernate 用 它 来 读 写 配 
置 文件 。 

Log4jjar (可 选 ) : Hibernate 使 用 Commons Logging API, 它 也 可 以 依次 使 用 Log4j 
作为 底层 实施 Log 的 机 制 . 如 果 上 下 文 类 目录 中 存在 Log4j 库 , 则 Commons Logging 
使 用 Log4j 和 它 在 上 下 文 类 路 径 中 寻找 的 log4j.properties 文件 。 可 以 使 用 在 
Hibernate 发 行 包 中 包含 的 那个 示例 Log4j 的 配置 文件 。 这 样 ， 把 Log4j.jar 和 它 的 
配置 文件 (位 于 src/ 目 录 中 ) 复制 到 程序 的 上 下 文 类 路 径 下 ， 就 可 以 在 后 台 看 究竟 
程序 是 如 何 运 行 的 。 


准备 数据 库 和 数据 库 连 接 池 


在 MySQL 的 数据 库 管理 系统 中 建立 一 个 数据 库 ， 名 为 hibernateTest， 并 在 这 个 数据 库 
中 建立 一 个 数据 表 ， 名 为 productlist， 其 中 表 的 字段 和 描述 如 表 17.1 所 示 。 
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表 17.1 productlist 表 的 描述 

字 段 名 类 型 描述 
pid varchar(15) 主键 ， 非 空 
pname varchar(30) 非 空 
peomp varchar(30) 非 空 
madew varchar(20) 可 为 空 
madedate date 可 为 空 
rprice float 可 为 空 
cprice float 可 为 空 
count int(11) 可 为 空 
description varchar(100) 可 为 空 


建立 productlist 表 的 SQL 语句 如 下 : 


CREATE TABLE 'productlist ( 
"pid' varchar(15) NOT NULL default ", 
"pname' varchar(30) NOT NULL default ", 
"pcomp' varchar(30) NOT NULL default ", 
"madew' varchar(20) default NULL， 
"madedate' date default NULL， 
"rprice' float default NULL, 
"cprice' float default NULL， 
"count int(11) default NULL, 
"description' varchar(100) default NULL， 
PRIMARY KEY (pid) 
) 
数据 库 建立 好 后 ， 然 后 在 web.xml 文件 中 配置 数据 库 连 接 池 。 下 面 是 web.xml 文件 的 
完整 内 容 , 具 体 Context 的 路 径 等 信息 应 根据 具体 情况 修改 ,其 中 Resource 和 ResourceParams 
元 素 用 于 配置 数据 库 连接 池 : 


<Context path="/17" docBase="E:\PublishBook\17"> 
<Resource name="jdbc/ hibernateTest " scope="Shareable" type="javax.sql.DataSource"/> 
<ResourceParams name="jdbc/ hibernateTest "> 
<parameter> 
<name>factory</name> 
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value> 
</parameter> 


<!-- ”数据 库 连 接 池 信息 -> 

<parameter> 
<name>url</name> 
<value>jdbc:mysql://localhost/hibernateTest</value> 

</parameter> 

<!--- ”数据 库 的 JDBC 驱动 程序 《一 > 

<parameter> 
<name>driverClassName</name> 
<value>com.mysql.jdbc.Driver</value> 
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</parameter> 
<!--- ”下 面 是 数据 库 的 用 户 名 和 密码 ”一 -> 
<parameter> 
<name>username</name> 
<value>root</value> 
</parameter> 
<parameter> 
<name>password</name> 
<value>ict</value> 
</parameter> 


<!-- DBCP 连接 池 选 项 --> 

<parameter> 
<name>maxWait</name> 
<value>3000</value> 

</parameter> 

<parameter> 
<name>maxldle</name> 
<value>100</value> 

</parameter> 

<parameter> 
<name>maxActive</name> 
<value>10</value> 

</parameter> 

</ResourceParams> 
</Context> 


全 注意 : 在 使 用 上 述 配置 文件 时 ， 不 能 包含 中 文 的 注释 。 

Tomcat 现在 通过 JNDI 的 方式 : java:comp/env/jdbc/hibernateTest 来 提供 连接 。 如 果 遇 到 
了 JDBC 驱动 所 报 的 exception 出 错 信息 , 应 该 在 没有 Hibernate 的 环境 下 ， 先 测试 JDBC 连 
接 池 本 身 是 否 配 置 正确 。 
各 注意 : 应 把 数据 库 驱动 程序 mysql-connector-java-3.0.16-ga-bin.jar 复制 到 Web 应 用 的 

WEB-INF\lib 目录 下 。 

下 面 是 一 个 用 于 测试 这 个 连接 池 是 否 正确 的 一 个 简单 的 JSP 页 面 ，dataSourcetestjsp 的 

代码 如 下 : 


<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import="java.sql.*javax.sql.*,javax.naming.”%> 


<% 
Connection conn=null; 
try{ 
InitialContext ctx = new InitialContext(); 
// 查 找 并 获取 数据 源 


DataSource ds = (DataSource) ctx.lookup("java:comp/env/jdbc/hibernateTest"); 
// 获 取 数 据 库 连接 

conn = ds.getConnection(); 

if(conn!=null){ 
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out.println(" 数 据 源 jdbc/hibernateTest 配置 正确 ! "); 


}catch(Exception ex){ 


out.println(" 数 据 源 jdbc/hibernateTest 配置 出 现 错误 ! "+ex); 


} 


%> 


“3ll* 


把 这 个 文件 复制 到 Web 应 用 的 根 目录 下 ,然后 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http:// 
localhost:8080/17/dataSourcetestjsp， 这 时 如 果 页 面 显 示 如 图 17.4 所 示 ， 则 表明 数据 库 连 接 


池 配 置 正确 了 。 


各 注意 : 关于 配置 文件 的 编写 请 参考 ServletJSP 标 。 导 


准 文档 。 


17.1.4 ”编写 持久 化 类 


数据 涯 jdbe/hibernate 配 置 正确 ! 


[BEd 


Lm mil ml EE 


图 17.4 “验证 数据 源 配置 


Hibernate 使 用 简单 的 Java 对 象 (Plain Old Java Objects) 这 种 编程 模型 来 进行 持久 化 。 
-个 POJO 很 像 JavaBeans， 它 通过 getter 和 setter 方法 访问 其 属性 ， 对 外 则 隐藏 了 内 部 实现 
的 细节 (假如 需要 ，Hibernate 也 可 以 直接 访问 其 属性 字段 ) 。 
下 面 是 本 例 中 使 用 的 持久 化 类 Product 的 源 代 码 ， 由 于 它 是 一 个 很 普通 的 JavaBeans， 


这 里 不 作 更 多 介绍 。 


package cn.ac.ict; 


import java.io.Serializable; 
import java.util.Date ; 


public class Product implements Serializable{ 


// 下 面 是 这 个 JavaBeans 的 属性 
private String pid ; 
private String pname; 
private String pcomp; 
private String pmadew; 
private Date pmadeyear'; 
private float realprice; 
private float cutprice; 
private int amount; 
private String description; 


public Product(X{ 


} 
/下 面 是 各 个 属性 的 获取 方法 
public String getPid(){ 
return pid; 
} 
public String getPname(){ 
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return pname; 

b 

public String getPcomp(){ 
return pcomp; 

日 

public String getPmadew(){ 
return pmadew; 

} 

public Date getPmadeyear(){ 
return pmadeyear; 

public float getRealprice(){ 
return realprice; 

1 

public float getCutprice(){ 
return cutprice; 

public int getAmount(){ 
return amount; 

public String getDescription(){ 
return description; 


} 


/下 面 是 各 个 属性 的 设置 方法 


public void setPid(String productid){ 
pid = productid; 

} 

public void setPname(String productname}{ 
pname = productname; 

} 

public void setPcomp(String productcomp){ 
pcomp = productcomp; 

b 

public void setPmadew(String productwX{ 
pmadew = productw; 

} 

public void setPmadeyear(Date madeyearj{ 
pmadeyear = madeyear; 

) 

public void setRealprice(float price)f 
realprice = price; 

} 

public void setCutprice(float priceX{ 
cutprice = price; 

; 

public void setAmount(int pamountj{ 
amount = pamount; 


} 


整合 


应 用 
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public void setDescription(String descr){ 
description = descr; 


} 


了 

Hibernate 对 属性 使 用 的 类 型 不 加 任何 限制 。 所 有 的 Java JDK 类 型 和 原始 类 型 (比如 
String、char 和 Date) 都 可 以 被 映射 ， 也 包括 Java 集合 框架 (Java Collections Framework ) 
中 的 类 。 可 以 把 它们 映射 成 为 值 、 值 集合 ， 或 者 与 其 他 实体 类 相关 联 。id 是 一 个 特殊 的 属 
性 , 代表 了 这 个 类 的 数据 库 标识 符 (主键 ), 对 类 似 于 Cat 这 样 的 实体 类 建议 使 用 。Hibernate 
也 可 以 使 用 内 部 标识 符 ， 但 这 样 会 失去 一 些 程序 架构 方面 的 灵活 性 。 

持久 化 类 不 需要 实现 什么 特别 的 接口 ， 也 不 需要 从 一 个 特别 的 持久 化 根 类 继承 下 来 。 
Hibernate 也 不 需要 使 用 任何 编译 器 处 理 ， 比 如 字 节 码 增强 操作 ， 它 独立 地 使 用 Java 反射 机 
制 和 运行 时 类 增强 (通过 CGLIB ) 。 所 以 不 依赖 于 Hibernate， 就 可 以 把 POJO 的 类 映射 成 
为 数据 库 表 。 


17.1.5 ”编写 Hibernate 配置 文件 


Hibernate 中 的 配置 文件 可 以 是 properties 文件 形式 的 ， 也 可 以 是 XML 文件 形式 的 ， 具 
体 的 编写 方法 在 后 面 的 小 节 中 会 详细 介绍 。 本 例 中 使 用 XML 文件 形式 的 配置 文件 ， 这 个 
XML 配置 文件 必须 放 在 上 下 文 类 路 径 (WEB-INF/classes) 下 面 ， 命 名 为 hibernate.cfg.xml 
(固定 命名 ) ， 完 整 代码 如 下 : 
<?xml version='1.0' encoding='utf-8'?> 
<!DOCTYPE hibernate-configuration 


PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN" 
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> 


<hibernate-configuration> 
<session-factory> 
<property name="connection.datasource">java:comp/env/idbc/hibernateTest</property> 
<property name="show_sql">false</property> 
<!-- ”使 用 MySQL 数据 库 用 语 --> 
<property name="dialect">org.hibernate.dialect.MySQLDialect</property> 


<!-- 映射 文件 一 > 


<mapping resource="Producthbm.xml"/> 
</session-factory> 


</hibernate-configuration> 


在 这 个 配置 文件 中 关闭 了 SQL 命令 的 Log， 同 时 告诉 Hibernate 使 用 MySQL 数据 库 用 
语 (Dialet) ， 以 及 如 何 得 到 JDBC 连接 (通过 Tomcat 声明 绑 定 的 JNDI 地 址 ) 。Dialet 是 
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必须 配置 的 ， 因 为 不 同 的 数据 库 都 和 “SQL 标准 ”有 一 些 差异 。Hibernate 会 根据 这 个 Dialet 
处 理 这 些 差异 ，Hibernate 支持 所 有 主流 的 商业 和 开放 源 代 码 数 据 库 。 

SessionFactory 是 Hibernate 中 的 一 个 概念 ， 表 示 对 应 一 个 数据 存储 源 。 通 过 创建 多 个 
XML 配置 文件 并 在 程序 中 创建 多 个 Configuration 和 SessionFactory 对 象 ， 就 可 以 支持 多 个 
数据 库 了 。 

在 hibernate.cfg.xml 中 的 最 后 一 个 元 素 声明 了 Producthbm.xml, 这 是 一 个 Hibernate XML 
映射 文件 , 对 应 于 持久 化 类 Product。 这 个 文件 包含 了 把 Product POJO 类 映射 到 数据 库 表 (或 
多 个 数据 库 表 ) 的 元 数据 。 


17.1.6 ”编写 映射 文件 


Hibernate XML 映射 文件 对 应 于 持久 化 类 , 它 的 作用 就 是 把 持久 化 类 的 属性 和 数据 表 中 的 
字段 进行 映射 ， 下 面 是 映射 文件 Producthbm.xml 的 完整 代码 ， 这 个 文件 必须 放 在 上 下 文 类 路 
径 (WEB-INF/classes) 下 面 ， 文 件 的 名 字 要 与 Hibernate 配置 文件 中 指定 的 映射 文件 名 一 致 。 


<?xml version="1.0"?> 

<!DOCTYPE hibernate-mapping 
PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 


<hibernate-mapping> 
<!---- 下 面 指定 的 类 名 必须 是 完全 限定 的 类 名 ， 对 应 的 数据 表 是 productlist ----- --> 
<class name="cn.ac.ict.Product" table="productlist"> 
<!-- 一 -数据 表 的 1D， 对 应 数据 表 中 的 pid 项 --- -> 
<id name="pid" type="string" unsaved-value="null" > 
<column name="pid" sql-type="char(15)" not-null="true"/> 
</id> 
<!------ 下 面 是 JavaBeans 中 属性 与 数据 表 中 列 的 映射 --- --> 
<property name="pname"> 
<column name="pname" sql-type="char(30)"/> 
</property> 


<property name="pcomp"> 
<column name="pcomp" sql-type="char(30)"/> 
</property> 


<property name="pmadew"> 
<column name="madew" sql-type="char(20)"/> 
</property> 


<property name="pmadeyear" type="date" > 
<column name="madedate"/> 
</property> 


<property name="realprice" type="float" > 
<column name="rprice"/> 
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</property> 


<property name="cutprice" type="float" > 
<column name="cprice"/> 
</property> 


<property name="amount" type="integer" > 
<column name="count" not-null="true"/> 
</property> 


<property name="description" type="string" > 
<column name="description" sql-type="char(100)"/> 
</property> 
</class> 
</hibernate-mapping> 
映射 文件 的 根 元 素 是 <hibernate-mapping>， 其 可 允许 的 子 元 素 在 Hibernate 中 都 有 规定 ， 
在 17.1.7 节 中 将 对 这 些 元 素 进 行 介绍 。 


17.1.7 编写 JSP 应 用 文件 


上 面 的 准备 工作 做 完 之 后 , 就 可 以 开始 Hibernate 的 Session 了 。Session (与 JSP 和 Servlet 
中 的 Session 不 一 样 ) 是 一 个 持久 化 管理 器 ， 通 过 它 从 数据 库 中 存 取 Product 的 对 象 的 数据 。 
首先 ， 要 从 SessionFactory 中 获取 一 个 Session (Hibernate 的 工作 单元 〉。 
SessionFactory sessionFactory = 
new Configuration().configure().buildSessionFactory(); 
通过 对 configure() 的 调用 来 装载 hibernate.cfg.xml 配置 文件 ,并 初始 化 成 一 个 Configuration 
实例 。 
在 创建 SessionFactory 之 前 ( 它 是 不 可 变 的 ) ， 可 以 访问 Configuration 来 设置 其 他 属性 
(甚至 修改 映射 的 元 数据 ) 。 应 该 在 哪里 创建 SessionFactory? 在 程序 中 又 如 何 访问 它 呢 ? 
SessionFactory 通常 只 是 被 初始 化 一 次 ， 例 如 通过 一 个 load-on-startup 的 Servlet 来 初始 
化 。 这 意味 着 开发 者 不 应 该 在 Serlvet 中 把 它 作 为 一 个 实例 变量 来 持 有 ， 而 应 该 放 在 其 他 地 
方 。 进 一 步 地 说 ， 需 要 使 用 单 例 (Singleton ) 模式 ， 开 发 者 才能 更 容易 地 在 程序 中 访问 
SessionFactory。 下 面 的 方法 就 同时 解决 了 两 个 问题 : 对 SessionFactory 的 初始 配置 与 便捷 使 
用 以 及 编写 一 个 辅助 的 类 文件 HibernateUtiljava: 
package cn.ac.ict; 
import org.hibernate.*; 
import org.hibernate.cfg.”; 


import org.apache.commons.logging.Log; 
import org.apache.commons.logging.LogFactory; 


public class HibernateUtil { 
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private static Log log = LogFactory.getLog(HibernateUtil.class); 
private static final SessionFactory sessionFactory; 


static { 
ty{ 
// 创建 SessionFactory 
sessionFactory = new Configuration().configure().buildSessionFactory(); 
} catch (Throwable ex) { 
// 输 出 日 志 信 息 
log.error("Initial SessionFactory creation failed.", ex); 
throw new ExceptionlnlnitializerError(ex); 


L 
public static final ThreadLocal session = new ThreadLocal(); 


public static Session currentSession() { 
Session s = (Session) session.get(); 
/ 打开 一 个 新 的 会 话 
if (s == null) { 
s = SessionFactory.openSession(); 
session.set(s); 
} 


return s; 


} 
// 关 闭 一 个 Hibernate 会 话 
public static void closeSession() { 
Session s = (Session) session.get(); 
if (s != null) 
s.close(); 
session.set(null); 


} 


这 个 类 不 但 在 它 的 静态 初始 器 中 使 用 了 SessionFactory， 还 使 用 了 一 个 ThreadLocal 变 


量 来 保存 Session 作为 当前 工作 线程 。 


SessionFactory 是 安全 线程 ， 可 以 由 很 多 线程 并 发 访问 并 获取 Session。 单 个 Session 不 
是 安全 线程 对 象 , 它 只 代表 与 数据 库 之 间 的 一 次 操作 。Session 通过 SessionFactory 获得 并 在 


所 有 的 工作 完成 后 关闭 。 


在 一 个 Session 中 ， 每 个 数据 库 操作 都 是 在 一 个 事务 (Transaction〉 中 进行 的 ， 这 样 就 


可 以 隔离 开 不 同 的 操作 《〈 甚 至 包括 只 读 操作 ) 。 使 用 Hibernate 的 Transaction API 从 底 


层 的 


事务 策略 中 《〈 本 例 中 是 JDBC 事务 ) “脱身 ”出 来 。 这 样 ， 开 发 者 不 需要 更 改 任何 源 代码 ， 


就 可 以 把 程序 部 署 到 一 个 由 容器 管理 事务 的 环境 中 去 〈 使 用 JTA) 。 


这 样 可 以 随心 所 欲 地 多 次 调用 HibernateUtil.currentSession0)， 而 且 每 次 都 会 得 到 当前 线 


程 的 同一 个 Session。 不 论 是 在 Servlet 代码 中 或 者 在 Servlet Filter 中 还 是 在 HTTP 结果 返 世 
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之 前 ， 开 发 者 都 必须 确保 这 个 Session 在 数据 库 访问 工作 完成 后 关闭 。 这 样 做 的 一 个 好 处 就 
是 可 以 容易 地 使 用 延迟 装载 (Lazy Initialization) 。 

下 面 是 获得 一 个 Session 然后 进行 数据 更 新 的 一 个 简单 JSP 页 面 (addjsp) : 

<%@ page language="java" pageEncoding="GB2312" %> 

<%@ page import="org.hibernate.*,org.hibernate.cfg.*,cn.ac.ict.*,java.text.*"%> 


<body> 
<p class="style1"> 
<% 
if(request.getParameter("pid")!=null){ 
// 获 取 多 个 请 求 参 数 
String pid = request.getParameter("pid"); 
String pname = request.getParameter("pname"); 
String pcomp = request.getParameter("pcomp"); 
String pmadew = request.getParameter("pmadew"); 
java.util.Date pmadeyear = DateFormat.getDatelnstance().parse(request.getParameter 
(pmadeyear )); 
out.printiIn(pmadeyear); 
float realprice =Float.parseFloat(request.getParameter("realprice")); 
float cutprice =Float.parseFloat(request.getParameter("cutprice")); 
int amount = Integer.parselnt(request.getParameter("amount")); 
String description = request.getParameter("description"); 


try{ 
Transaction tx=null; 

// 根 据 客户 的 请 求 信 息 构建 一 个 持久 化 对 象 
Product product = new Product(); 
product.setPid(pid); 
product.setPname(pname); 
product.setPcomp(pcomp); 
product.setPmadew(pmadew); 
product.setPmadeyear(pmadeyear); 
product.setRealprice(realprice); 
product.setCutprice(cutprice); 
product.setAmount(amount); 
product.setDescription(description); 
// 开 始 一 个 Hibernate 会 话 
Session Hsession = HibernateUtil.currentSession(); 

tx= Hsession.beginTransaction(); 

// 将 持久 化 对 象 保存 到 数据 库 

Hsession.save(product); 
tx.commit(); 
out.print(product); 


}catch(Exception ej{out.print("insert error!"+e); } 


y 
%> 
</p> 
<p>Add New Product:</p> 
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<!-- 一 一- 一- 下面 是 用 于 接收 输入 的 表单 一 -一 -一 -一 一 
<form action="add.jsp" method="post" name="form1" target="_self’> 
<p>Product ID: 
<input name="pid" type="text" id="pid"> 
</p> 
<p>ProductName: 
<input name="pname" type="text" id="pname"> 
</p> 
<p>Company: 
<input name="pcomp" type="text" id="pcomp"> 
</p> 
<p>Made Where : 
<input name="pmadew" type="text" id="pmadew"> 
</p> 
<p>Made Date : 
<input name="pmadeyear type="text" id="pmadeyear"> 
</p> 
<p>Real Price: 
<input name="realprice" type="text" id="realprice"> 
</p> 
<p>Cut Price: 
<input name="cutprice" type="text" id="cutprice"> 
</p> 
<p>Amount : 
<input name="amount" type="text" id="amount"> 
</p> 
<p>Description: 
<input name="description " type="text" id="description"> 
</p> 
<p> 
<input type="submit" name="Submit" value=" 提 交 "> 
</p> 
</form> 


人 注意 : 这 个 JSP 文件 对 于 读者 不 正确 的 输入 不 作 处 理 ， 读 者 在 输入 数据 时 注意 要 依据 数 
据 类 型 来 输入 ， 如 对 于 生产 日 期 就 应 按照 YYYY-MM-DD 的 格式 输入 。 


17.1.8 编译 并 发 布 Web 应 用 


读者 可 以 按照 如 下 步骤 发 布 这 个 Web 应 用 : 
(1) 编译 HiberateUtil 类 ， 需 要 把 Hibemate 的 核心 包 和 Hiberate 运行 必需 的 包 存 放 

在 类 路 径 中 。 

(2) 检查 文件 是 否 按照 正确 的 位 置 存放 : 

口 Hibernate 配置 文件 和 映射 文件 存放 在 Web 应 用 的 WEB-INF\classes 目录 下 。 

口 Hibemate 的 核心 包 和 Hibermmate 运行 必需 的 包 以 及 数据 库 驱 动 程序 存放 在 WEB- 
INF\lib 目录 下 。 

(3) 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/17/add.jsp， 
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在 显示 的 页 面 中 输入 数据 ， 如 图 17.5 所 示 。 
(4) 提交 后 ， 在 MySQL 数据 库 中 查询 结果 ， 可 以 看 到 刚刚 输入 的 信息 都 被 保存 到 数 
据 库 中 了 ， 如 图 17.6 所 示 。 


1 2886-0: 190000 ! 98888 | 


如 ount ， 加 


Desoription: 网 ER set <0.00 sec) 


提交 | FE 
et 
图 175 产品 信息 图 17.6 Hibemate 数据 持久 化 


17.2 Hibernate 技术 介绍 


Hibernate 技术 涉及 很 多 方面 , 下 面 初步 介绍 几 个 方面 ,读者 如 果 需 要 详细 了 解 Hibernate 
技术 ， 请 参考 Hibernate 文档 。 


17.2.1 映射 定义 


Hibernate XML 映射 文件 把 Hibernate 持久 类 和 数据 库 中 的 数据 字段 进行 映射 ， 本 节 将 
介绍 编写 Hibernate XML 映射 文件 时 使 用 的 一 些 元 素 。 


1. class 元 素 
使 用 class 元 素 定义 一 个 持久 化 类 ， 下 面 是 class 元 素 的 语法 定义 : 
<class 


name="ClassName" 
table="tableName" 
discriminator-value="discriminator_value" 
mutable="true|false" 
schema="owner" 
catalog="catalog" 
proxy="ProxyInterface”" 
dynamic-update="truelfalse" 
dynamic-insert= "truelfalse” 
select-before-update="true|false”" 
polymorphism="implicitlexplicit" 
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where="arbitrary sql where condition" 
persister="PersisterClass" 
batch-size="N" 
optimistic-lock="nonelversionldirtylall" 
lazy="truelfalse”" 
entity-name="EntityName" 
check="arbitrary sql check condition" 
rowid="rowid" 
Subselect="SQL expression" 
abstract="truel|false”" 
entity-name="EntityName" 
node="element-name" 

/> 


所 有 属性 都 是 可 选 的 ， 下 面 简单 介绍 几 个 属性 的 作用 和 使 用 方法 : 

口 name (可 选 ) : 持久 化 类 (或 者 接口 ) 的 完整 类 名 (包括 包 名 ) 。 如 果 这 个 属性 不 
存在 ，Hibernate 将 假定 这 是 一 个 非 POJO 的 实体 映射 。 

口 table《〈 可 选 ， 默 认 是 类 的 非 全 限定 名 ) : 对 应 的 数据 库 表 名 。 

如 例 中 可 以 看 到 持久 化 类 的 名 字 是 cn.ac.ict.Cat， 在 数据 库 中 对 应 的 表 名 是 cats。 


全 注意 : 类 (或 者 接口 ) 的 Java 完整 类 名 是 指 包含 类 或 接口 所 在 包 的 名 字 ， 如 例 中 Product 
类 在 cn.ac.ict 包 中 , 则 其 Java 全 限定 名 是 cn.ac.ict. Product, 非 全 限定 名 是 Product。 
2. id 元 素 
被 映射 的 类 必须 定义 对 应 数据 库 表 的 主键 字段 。 大 多 数 类 有 一 个 JavaBeans 风格 的 属 
性 ， 为 每 一 个 实例 包含 惟一 的 标识 。<id> 元 素 定义 了 该 属性 到 数据 库 表 的 主键 字段 的 映射 。 
id 元 素 的 语法 定义 如 下 : 
<id 
name="propertyName” 
type="typename” 
column="column_name" 
unsaved-value="nulllany|none|lundefined|id_value" 
access="field|property|ClassName" 
node="element-namel@attribute-namelelement/@attribute|."> 
<generator class="generatorClass"/> 
</id> 
其 中 : 
口 name (可 选 ) : 标识 属性 的 名 字 。 
口 type (可 选 ) : 标识 Hibemate 类 型 的 名 字 。 
口 column〈 可 选 ， 默 认为 属性 名 ) : 主键 字段 的 名 字 。 
全 注意 ; 如 果 name 属性 不 存在 ， 会 认为 这 个 类 没有 标识 属性 。 
id 元 素 有 一 个 可 选 的 <generator> 子 元 素 ， 它 是 一 个 Java 类 的 名 字 ， 用 来 为 该 持久 化 类 
的 实例 生成 惟一 的 标识 。 如 果 这 个 生成 器 实例 需要 某 些 配置 值 或 者 初始 化 参数 ， 可 以 用 
<param> 元 素来 传递 。 例 如 : 
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<id name="id" type="long" column="cat id"> 
<generator class="org.hibernate.id.TableHiLoGenerator"> 
<param name="table">uid_table</param> 
<param name="column">next_hi_value_column</param> 
</generator> 
</id> 
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名 注意: 标识 的 生成 策略 有 很 多 种 ， 具 体 使 用 的 策略 可 以 根据 实际 需要 而 定 ， 读 者 如 果 需 


要 了 解 可 以 查看 Hibernate 的 参考 文档 。 
3. property 元 素 


<property> 元 素 为 类 定义 一 个 持久 化 的 JavaBeans 风格 的 属性 。 <property> 元 素 的 语法 定 


义 如 下 : 


<property 
name="propertyName” 
column="column_name" 
type="typename”" 
update="truelfalse" 
insert="truelfalse" 
formula="arbitrary SQL expression" 
access="field|property|ClassName” 
lazy="truelfalse" 
unique="truelfalse" 
not-null="truelfalse”" 
optimistic-lock="truelfalse" 
node="element-namel@attribute-namelelement/@attribute|.” 

lw 


口 name: 属性 的 名 字 ， 以 小 写字 母 开 头 ， 与 持久 化 类 中 的 属性 名 字 一 致 。 

口 column 〈 可 选 一 默认 为 属性 名 字 ) : 对 应 的 数据 库 字 段 名 。 也 可 以 通过 峰 
<column> 元 素 指 定 。 

口 type〈 可 选 ) : 一 个 Hibernate 类 型 的 名 字 。 

Hibernate 类 型 可 以 是 如 下 几 种 : 


套 的 


口 Hibermate 基础 类 型 之 一 〈 比 如 : integer、string、character、date、timestamp 、float、 


binary、 serializable、object 和 blob) 。 


口 一 个 Java 类 的 名 字 ， 这 个 类 属于 一 种 默认 基础 类 型 (比如 : int、float、char、 


java.lang.String、java.util.Date、java.lang.Integer 和 java.sql.Clob) 。 
口 一 个 可 以 序列 化 的 Java 类 的 名 字 。 
口 一 个 自 定义 类 型 的 类 的 名 字 〈 比 如: cn.ac.icttype.MyCustomType) 。 
如 果 不 指定 类 型 ，Hibernarte 会 使 用 映射 来 得 到 这 个 名 字 的 属性 ， 以 此 来 猜测 正 
Hibemate 类 型 。Hibernate 会 按照 规则 2，3，4 的 顺序 对 属性 读 取 器 (getter 方 法 ) 的 返 
进行 解释 。 


确 的 
回 类 


全 注意 : 在 某 些 情况 下 仍然 需要 type 属性 。 比如， 为 了 区 别 Hibernate.DATE 和 Hibernate. 


TIMESTAMP， 或 者 为 了 指定 一 个 自 定义 类 型 。 
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17.2.2 Hibernate 的 类 型 


1. 基本 值 类 型 

Hibernate 内 建 的 基本 映射 类 型 可 以 大 致 分 为 如 下 几 类 : 

口 Integer long、 short、 float、 double、character、byte、boolean、yes no、true false 

这 些 类 型 都 对 应 Java 的 原始 类 型 或 者 其 封装 类 , 来 符合 (特定 厂商 的 ) SQL 字段 类 型 。 
boolean、yes_no 和 true_false 都 是 Java 中 boolean 或 者 java.lang.Boolean 的 另外 说 法 。 

口 string 

从 java.lang.String 到 VARCHAR (或 者 Oracle 的 VARCHAR2) 的 映射 。 

口 date、 time、timestamp 

从 java.util.Date 和 其 子 类 到 SQL 类 型 DATE、TIME 和 TIMESTAMP (或 等 价 类 型 ) 的 
映射 。 

口 calendar、 calendar date 

从 java.util.Calendar 到 SQL 类 型 TIMESTAMP 和 DATE (或 等 价 类 型 ) 的 映射 。 

口 big decimal、 big integer 

从 java.math.BigDecimal 和 java.math.BigInteger 到 NUMERIC( 或 者 Oracle 的 NUMBER 
类 型 ) 的 映射 。 

口 locale、 timezone、currency 

从 java.util.Locale、java.util.TimeZone 和 java.util.Currency 到 VARCHAR (或 者 Oracle 
的 VARCHAR2 类 型 ) 的 映射 ，locale 和 currency 的 实例 被 映射 为 它们 的 ISO 代码 。timezone 
的 实例 被 影射 为 它 的 ID。 

口 class 

从 java.lang.Class 到 VARCHAR (或 者 Oracle 的 VARCHAR2 类 型 ) 的 映射 。class 被 
映射 为 它 的 全 限定 名 。 


口 binary 
把 字 节 数组 (Byte Arrays〉 了 映射 为 对 应 的 SQL 二 进 制 类 型 。 
口 text 


把 长 Java 字符 串 映 射 为 SQL 的 CLOB 或 者 TEXT 类 型 。 

口 serializable 

把 可 序列 化 的 Java 类 型 映射 到 对 应 的 SQL 二 进 制 类 型 。 也 可 以 为 一 个 并 非 默 认为 基 
本 类 型 的 可 序列 化 Java 类 或 者 接口 指定 Hibernate 类 型 serializable。 

口 clob、blob 

JDBC 类 java.sql.Clob 和 java.sql.Blob 的 映射 。 某 些 程序 可 能 不 适合 使 用 这 个 类 型 ， 
为 blob 和 clob 对 象 可 能 在 一 个 事务 之 外 是 无 法 重用 的 。 

在 org.hibernate.Hibernate 中 ， 定 义 了 基础 类 型 对 应 的 Type 常量 。 比 如 ，Hibernate.STRING 
代表 string 类 型 。 
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2. 自 定义 值 类 型 

开发 者 创建 属于 他 们 自己 的 值 类 型 也 是 很 容易 的 。 比 如 说 ， 开 发 者 可 能 希望 持久 化 一 
个 java.lang.BigInteger 类 型 的 属性 ， 使 其 持久 化 成 为 VARCHAR 字段 。Hibernate 没有 内 置 
这 样 一 种 类 型 。 自 定义 类 型 能 够 映射 一 个 属性 〈 或 集合 元 素 ) 到 不 止 一 个 数据 库 表 字段 。 
比如 说 ， 可 能 有 这 样 的 Java 属性 : getName(O/setName() 是 java.lang.String 类 型 的 ， 对 应 的 持 
久 化 到 3 个 字段 : FIRST NAME、INITIAL 和 SURNAME。 

要 实现 一 个 自 定义 类 型 ， 可 以 实现 org.hibernate.UserType 或 org.hibemate. 
CompositeUserType 中 的 任 一 个 ， 并 且 使 用 类 型 的 Java 全 限定 类 名 来 定义 属性 。 


17.2.3 ”Hibernate 事务 


Hibernate 是 对 JDBC 的 轻 量 级 对 象 封 装 ，Hibernate 本 身 是 不 具备 Transaction 处 理 功 能 
的 , Hibernate 的 Transaction 实际 上 是 底层 的 JDBC Transaction 的 封装 ,或 者 是 JTA Transaction 
的 封装 , Hibernate 可 以 配置 为 JDBCTransaction 或 者 是 JTATransaction, 这 取决 于 在 Hibernate 
配置 文件 中 的 配置 

#hibernate.transaction.factory_class net.sf.hibernate.transaction.JTATransactionFactory 

#hibernate.transaction.factory_class net.sf.hibernate.transaction.JDBCTransactionFactory 


如 果 什 么 都 不 配置 ， 默 认 情 况 下 使 用 JDBCTransaction， 如 果 配 置 为 : 
hibernate.transaction.factory_class net.sf.hibernate.transaction.JTATransactionFactory 
将 使 用 JTATransaction。 


17.3” ”Hibernate 配置 


Hibernate 使 用 数据 库 和 配置 信息 来 为 应 用 程序 提供 持久 化 服务 ， 它 实现 与 数据 库 连接 
的 过 程 如 图 17.7 所 示 。 

由 于 Hibernate 是 为 了 能 在 各 种 不 同 环境 下 工作 而 设计 的 , 因此 存在 着 大 量 的 配置 参数 ， 
Hibemate 得 到 配置 信息 存在 很 多 种 方式 。 

口 编程 的 配置 方式 。 

口 传 一 个 java.util.Properties 实例 给 Configuration.setProperties()。 


口 将 hibemate.properties 放置 在 类 路 径 (classpath) 
的 根 目录 下 (root directory) 。 读 取 配置 信息 


口 通过 java -Dproperty=value 来 设置 系统 (System) | 

属性 。 
口 在 hibemate.cfg.xml 中 加 入 元 素 <property>。 贡生 国 一 
其 中 使 用 hibernate.properties 文件 是 最 简单 的 方式 , 下 面 (Session) 


结合 这 几 种 方式 讲述 Hibemate 是 如 何 实 现 数 据 库 连 接 的 。 图 17.7 ”Hibernate 获得 数据 库 连接 
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一 个 org.hibernate.cfg.Configuration 实例 代表 了 一 个 应 用 程序 中 Java 类 型 到 SQL 数据 库 
映射 的 完整 集合 。Configuration 被 用 来 构建 一 个 〈 不 可 变 的 ) SessionFactory。 


17.3.1 ”可 编程 的 配置 方式 


可 编程 的 配置 方式 并 不 是 最 好 的 方式 , 但 通过 了 解 可 编程 的 配置 方式 , 可 以 对 Hibernate 
的 配置 过 程 的 实现 有 更 好 的 理解 ， 而 且 通 过 这 种 方式 来 了 解 Hibernate 的 一 些 配 置 属性 的 作 
用 和 使 用 方法 。 
1. 获得 配置 属性 
编程 的 配置 方式 是 直接 实例 化 Configuration 来 获取 一 个 实例 , 并 为 它 指定 XML 映射 定 
义 文件 。 如 果 映 射 定义 文件 在 类 路 径 〈classpath) 中， 就 使 用 addResource() 方 法 把 XML 映 
射 定义 文件 的 信息 加 载 从 而 进行 Hibernate 的 配置 。 
Configuration cfg = new Configuration().addResource("ltem.hbm.xml") 
.addResource("Bid.hbm.xml”); 
-种 更 好 的 方式 是 指定 被 映射 的 类 ， 让 Hibernate 寻找 映射 定义 文件 : 
Configuration cfg = new Configuration().addClass(org.hibernate.auction.ltem.class).addClass(org. 
hibernate.auction.Bid.class); 
Hibernate 将 会 在 类 路 径 中 寻找 名 字 为 /org/hibernate/auction/Item.hbm.xml 和 /org/ 
hibernate/auction/Bid.hbm.xml 映射 定义 文件 。 这 种 方式 消除 了 任何 对 文件 名 的 硬 编码 。 
Configuration 也 允许 开发 者 编码 指定 配置 属性 : 
Configuration cfg = new Configuration() 
.addClass(org.hibernate.auction.ltem.class) 
.addClass(org.hibernate.auction.Bid.class) 
.SetProperty("hibernate.dialect", 
"org.hibernate.dialect.MySQLInnoDBDialect") 
.setProperty("hibernate.connection.datasource", "java:comp/env/idbc/test") 
.SetProperty("hibernate.order_updates", "true"); 
Configuration 实例 是 一 个 启动 期 间 的 对 象 ， 一 旦 它 完成 创建 SessionFactory 的 任务 ， 它 
2. 获得 SessionFactory 
当 所 有 了 映射 定义 被 Configuration 解析 后 , 应 用 程序 必须 获得 一 个 用 于 构造 Session 实例 
的 工厂 。 这 个 工厂 将 被 应 用 程序 的 所 有 线程 共享 : 


SessionFactory sessions = cfg.buildSessionFactory(); 


Hibernate 允许 应 用 程序 创建 多 个 SessionFactory 实例 。 这 对 使 用 多 个 数据 库 的 应 用 来 
说 很 有 用 。 

3. JDBC 连接 

通常 希望 SessionFactory 来 创建 和 缓存 〈 数 据 库 连接 池 ) JDBC 连接 。 如 果 采 用 这 种 方 


第 17 章 在 JSP 中 使 用 Hibemate 实现 数据 持久 化 “325 。 


式 ， 只 需要 如 下 所 示 那 样 ， 打 开 一 个 Session: 

// 打开 一 个 新 的 Session 

Session session = sessions.openSession(); 

旦 需要 进行 数据 访问 时 ， 就 会 从 连接 池 中 获取 一 个 JDBC 连接 。 为 了 使 这 种 方式 工 

作 起 来 , 需要 向 Hibernate 传递 一 些 JDBC 连接 的 属性 。 所 有 Hibernate 属性 的 名 字 和 语义 都 
在 org.hibernate.cfg.Environment 中 定义 。 下 面 将 描述 JDBC 连接 配置 中 最 重要 的 几 项 设置 。 

如 果 设 置 如 表 17.2 所 示 的 属性 ，Hibernate 将 使 用 java.sql.DriverManager 来 获得 〈 和 组 
存 ) JDBC 连接 。 


表 17.2 Hibernate JDBC 属 性 


JDBC 驱 动 类 
JDBCURL 

数据 库 
数据 库 
连接 池 容 量 上 限 数目 


hibernate.connection.driver_class 


hibernate.connection.url 


hibernate.connection.username 


hibernate.connection.password 


hibernate.connection.pool size 


但 Hibernate 自 带 的 连接 池 算 法 相当 不 成 熟 。 它 只 是 为 了 让 初学 者 快 些 上 手 ， 不 适合 用 
于 产品 系统 或 性 能 测试 中 。 出 于 最 佳 性 能 和 稳定 性 考虑 应 该 使 用 第 三 方 的 连接 池 。 

连接 池 的 特定 设置 替换 hiberate.connection.pool size， 这 将 关闭 Hibernate 自 带 的 连接 
池 。 例 如 ， 可 以 考虑 使 用 Tomcat 的 连接 池 。 

为 了 能 在 应 用 程序 服务 器 (Application Server) 中 使 用 Hibernate， 应 当先 将 DataSource 


表 17.3 所 示 ) 中 的 一 个 。 


表 17.3 ”Hibernate 数据 源 属性 

用 途 
数据 源 JNDI 名 字 
JNDI 提 供 者 的 URL《〈 可 选 ) 
JNDI InitialContextFactory 类 (可 选 ) 
数据 库 用 户 〈 可 选 ) 
数据 库 用 户 密码 〈 可 选 ) 


属 性 名 
hibernate.connection.datasource 
hibernate.jndi.url 


hibernate.indi.class, 


hibernate.connection.username 


hibernate.connection.password, 


下 面 是 一 个 使 用 应 用 程序 服务 器 JNDI 数据 源 的 hibernate.properties 样 例文 件 : 


# 数 据 源 JNDI 名 字 

hibernate.connection.datasource = java:/comp/env/jdbc/test 
# 工 厂 类 

hibernate transaction.factory_class =\ 
org.hibernate.transaction.JTATransactionFactory 

hibernate transaction.manager_lookup_class =\ 
org.hibernate.transaction.JBossTransactionManagerLookup 
hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect 


从 JNDI 数 据 源 获 得 的 JDBC 连接 将 自动 参与 应 用 程序 服务 器 中 容器 管理 的 事务 中 去 。 
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任何 连接 配置 属性 的 属性 名 要 以 “hibernate.connection” 前 级 开头 ,例如 , 可 以 使 用 hibernate. 
connection.charSet 来 指定 charSet。 
通过 实现 org.hibernate.connection.ConnectionProvider 接口 ， 可 以 定义 属于 自己 的 获得 
JDBC 连接 的 插件 策略 。 通 过 设置 hibernate.connection.provider_ class， 可 以 选择 一 个 自 定义 
的 实现 。 
全 注意 : 除了 以 上 属性 外 还 有 大 量 属性 能 用 来 控制 Hibemate 在 运行 期 的 行为 ， 它 们 都 是 可 
选 的 ， 并 拥有 适当 的 默认 值 ， 这 里 不 详细 介绍 。 


17.3.2 XML 配置 文件 方式 


另 一 个 配置 方法 是 在 hibernate.cfg.xml 文件 中 指定 一 套 完 整 的 配置 。 这 个 文件 可 以 当成 
hibernate.properties 的 替代 ， 它 使 用 标准 的 XML 语法 ， 是 比较 受 欢迎 的 一 种 方式 。 

下 面 是 一 个 配置 文件 的 例子 : 

<?xml version='1.0' encoding='utf-8'?> 

<!DOCTYPE hibernate-configuration PUBLIC 


"-//Hibernate/Hibernate Configuration DTD 3.0//EN" 
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"> 


<hibernate-configuration> 
<session-factory> 
<!-- ”数据 库 连接 设置 --> 
<property name="connection.driver_class">com.mysql.jdbc.Driver</property> 
<property name="connection.url">jdbc:mysql://localhost/hibernate_test</property> 


<property name="connection.username">root</property> 
<property name="connection.password">ict</property> 


<!-- JDBC 连接 池 〈 使 用 内 置 的 连接 池 ) --> 


<property name="connection.pool_size">1</property> 


<!-- SQL dialect --> 
<property name="dialect">org.hibernate.dialect.MySQLDialect</property> 


<!--- 显示 所 有 的 SQL 语句 到 标准 输出 --> 
<property name="show_sql">true</property> 


<!-- 启动 时 删除 并 新 建 数据 库 schema --> 
<property name="hbm2ddl.auto">create</property> 


<mapping resource="Studenthbm.xml"/> 
</session-factory> 


</hibernate-configuration> 
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全 注意 : 在 XML 配置 文件 中 使 用 的 属性 与 前 面 介 绍 的 属性 名 字 是 基本 一 样 的 ， 惟 一 的 差 
别 就 在 于 XML 配置 文件 中 的 属性 名 省 略 了 hibernate 前 缓 。 
使 用 XML 配置 使 得 启动 Hibernate 变 得 非常 简单 , 而 且 还 具有 XML 语法 的 优势 。 如 下 
所 示 ， 一 行 代码 就 可 以 获得 一 个 SessionFactory 实例 : 
SessionFactory sf = new Configuration().configure().buildSessionFactory(); 
另外 可 以 使 用 如 下 代码 来 添加 一 个 不 同 的 XML 配置 文件 : 
SessionFactory sf = new Configuration().configure("catdb.cfg.xml").buildSessionFactory(); 


17.4 小 结 


Hibernate 是 一 个 JDO 工具 。 它 的 工作 原理 是 通过 文件 将 值 对 象 和 数据 库 表 之 间 建 立 起 
一 个 映射 关系 ， 这 样 ， 开 发 者 只 需要 通过 操作 这 些 值 对 象 和 Hibemate 提供 的 一 些 基本 类 ， 
就 可 以 达到 使 用 数据 库 的 目的 。 

在 本 章 中 简单 介绍 了 Hibernate 的 使 用 和 一 些 基 本 的 知识 ， 读 者 要 学 好 Hibernate， 就 应 
该 努力 搞 懂 关 系 映射 的 原理 ， 多 实践 体会 。 
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软件 应 用 的 设计 是 一 个 在 软件 开发 中 很 重要 的 环节 ， 设 计 不 好 ， 往 往 使 前 面 的 工作 变 
得 没有 意义 。 在 软件 设计 的 过 程 中 不 但 要 考虑 设计 模式 的 问题 ， 而 且 还 需要 考虑 调试 、 测 
试 、 安 全 等 方面 的 问题 ， 在 本 章 中 将 简单 介绍 JSP Web 应 用 的 设计 和 实践 方面 的 一 些 问题 ， 
读者 可 以 根据 这 些 知 识 更 好 地 学 习 软 件 设计 。 


18.1 可 维护 性 与 可 扩展 性 设计 


当 谈 到 设计 时 ， 读 者 并 不 一 定 就 会 想到 是 软件 的 设计 ， 因 为 在 其 他 很 多 行业 都 有 设计 ， 
事先 考虑 好 相关 的 因素 会 使 得 设计 更 加 简单 化 ， 例 如 要 设计 一 个 厨房 ， 就 要 事先 考虑 好 水 
管 、 电 线 、 窗 户 和 门 的 位 置 ， 如 果 不 能 事先 考虑 好 这 些 因 素 ， 就 会 在 实际 使 用 时 碰 到 很 多 
问题 ， 这 个 道理 同样 适合 于 软件 的 设计 ， 在 设计 时 就 要 对 要 达成 的 目标 和 将 来 可 能 做 的 改 
动 有 一 定 的 了 解 ， 并 在 设计 时 为 它们 留 出 足够 的 空间 。 

软件 工业 与 其 他 工业 的 某 些 形式 是 很 相似 的 ， 尤 其 是 建筑 行业 。 虽 然 这 种 比较 应 该 在 
不 同 的 层次 上 进行 ， 它 们 之 间 还 是 有 一 些 不 同 的 。 通 常 建筑 设计 的 目的 是 很 确定 的 ， 它 必 
须 能 够 经 受 环境 的 已 知 程度 的 变化 ， 但 软件 的 设计 就 不 像 建筑 设计 那样 准确 ， 它 显得 更 加 
动态 化 ， 在 软件 的 生命 周期 中 ， 可 能 涉及 一 些 更 改 ， 有 时 可 能 只 是 消除 一 些小 缺陷 ， 而 更 
多 地 可 能 是 软件 功能 的 变更 和 增加 ， 这 些 变更 是 决定 软件 设计 特点 的 重要 原因 ， 一 般 在 软 
件 设计 的 过 程 中 需要 考虑 软件 的 可 维护 性 、 可 扩展 性 、 可 重用 性 以 及 健壮 性 等 ， 下 面 简单 
介绍 可 维护 性 和 可 扩展 性 。 


18.1.1 可 维护 性 


简单 而 言 ， 可 维护 性 是 指 一 个 软件 在 业务 逻辑 〈 包 括 需求 ) 、 实 现 技术 改变 时 是 否 可 
以 被 轻松 地 修改 。 跨 越 时 间 的 复 用 和 易 维护 性 很 相近 ， 但 前 者 更 多 地 侧重 如 何 完全 不 动 地 
使 用 ， 而 后 者 则 是 侧重 让 改动 的 影响 更 小 。 

对 业务 单一 的 公司 而 言 ， 可 维护 性 是 软件 仅 次 于 稳定 性 的 第 二 属性 ， 对 多 业务 公司 而 
言 ， 或 许 要 排 在 可 复 用 性 之 后 。 

当 软件 易 维 护 性 高 时 ， 意 味 着 可 以 更 快 地 适应 业务 罗 辑 变化 ， 这 对 于 新 兴 的 小 公司 而 
言 经 常 是 生存 的 依靠 。 因 为 小 公司 比 之 大 公司 ， 更 可 能 生产 频繁 升级 的 甚至 是 用 户 定制 的 
软件 ， 这 对 于 那些 说 不 清楚 自己 想 要 什么 的 用 户 而 言 具 有 很 大 吸引 力 。 

当 软件 易 维护 性 高 时 ， 还 可 以 很 容易 地 采用 新 技术 ， 这 将 更 有 利于 将 产品 推 到 市 场 前 
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沿 ， 保 持 竞 争 力 和 增进 技术 积累 ， 这 对 于 根基 已 稳 的 大 公司 而 言 是 一 个 长 远 战略 。 有 很 多 
大 型 产品 (如 数据 库 产 品 ) ， 其 业务 逻辑 很 少 变动 ， 改 进 技术 是 主要 的 工作 。 


18.1.2 ”可 扩展 性 


软件 系统 的 另外 一 个 很 重要 的 方面 是 它 的 可 扩展 性 ， 也 就 是 对 其 进行 扩展 和 增强 的 能 
力 。 一 个 设计 良好 的 软件 应 该 有 一 个 预定 义 好 的 框架 ， 使 得 已 有 的 特性 可 以 很 容易 地 被 修 
改 ， 而 新 的 特性 又 可 以 很 容易 地 被 加 入 ， 并 且 不 会 对 系统 的 其 他 部 分 产生 副作用 ， 尤 其 对 
于 那些 以 任务 为 中 心 的 商业 系统 ， 可 扩展 性 是 软件 的 一 个 很 重要 的 因素 ， 它 可 以 使 软件 保 
持 和 商业 处 理 同 步 ， 从 而 降低 了 费用 。 


18.2 JSP Web 应 用 的 设计 


在 对 软件 设计 方面 有 了 一 些 了 解 后 ， 下 面 开始 介绍 基于 Java 的 两 种 常用 设计 : 以 页 面 
为 中 心 的 设计 和 MYVC 设计 。 


18.2.1 以 页 面 为 中 心 的 设计 (Model 1) 


第 一 个 构建 软件 的 通用 架构 是 以 页 面 为 中 心 的 设计 也 是 Web 应 用 程序 集合 在 一 起 的 最 
简单 形式 ， 在 这 种 设计 中 ， 只 需要 关注 JSP 页 面 的 编写 ， 其 基本 的 描述 如 图 18.1 所 示 。 

在 使 用 Java 技术 建立 Web 应 用 的 实例 中 ， 由 于 JSP 技术 的 发 展 ， 很 快 这 种 便于 掌握 和 
可 实现 快速 开发 的 技术 就 成 了 创建 Web 应 用 的 主要 技术 。JSP 页 面 中 可 以 非常 容易 地 结合 
业务 逻辑 (jsp:useBean) 、 服 务 端 处 理 过 程 〈jsp:scriptlet) 和 HTML (<html>) ， 在 JSP 页 
面 中 同时 实现 显示 ， 业 务 逻 辑 
和 流程 控制 ， 从 而 可 以 快速 地 
完成 应 用 开发 。 现 在 很 多 的 
Web 应 用 就 是 由 一 组 JSP 页 面 
构成 的 。 这 种 以 JSP 为 中 心 的 
开发 模型 可 以 称 之 为 Model 1 。 

在 这 种 设计 模式 时 ， 有 两 
种 方法 可 以 实现 数据 的 共享 ， 
一 种 是 把 所 有 访问 数据 库 的 
SQL 语句 写 在 JSP 页 面 中 来 连 
接 数 据 库 并 得 到 返回 的 结果 ; 
另 一 种 是 把 访问 数据 库 的 代码 单独 放 到 一 个 Java 类 或 者 自 定义 的 标签 中 ， 例 如 JSTL 中 的 
一 些 SQL 标签 。 这 种 方式 是 JSP Web 设计 模式 中 最 不 具有 可 维护 性 的 了 ， 因 为 ， 一 旦 数据 
库 的 访问 策略 变 了 ， 就 需要 把 所 有 需要 访问 数据 库 的 页 面 进行 修改 。 


图 18.1 Model 1 架构 
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另 一 种 在 以 页 面 为 中 心 的 应 用 中 访问 数据 的 方式 是 使 用 JavaBeans， 使 用 JavaBeans 表 
示 系 统 中 需要 持久 化 的 实体 ， 如 图 18.2 所 示 。 例 如， 开发 者 可 以 使 用 一 个 Product 对 象 封 装 
系统 中 要 处 理 的 产品 信息 ， 这 样 访问 数据 库 的 代码 就 从 JSP 页 面 中 分 离 出 来 ， 被 放 入 了 可 
重用 的 JavaBeans 类 中 , 这 样 就 可 以 在 获取 应 用 的 高 可 维护 性 的 同时 也 获取 了 代码 的 可 重用 
性 ， 数 据 库 的 访问 策略 变化 时 只 需要 更 改 几 个 JavaBeans 类 。 


图 18.2 ”使 用 JavaBeans 访问 数据 库 的 Model 1 


这 种 开发 模式 在 进行 快速 和 小 规模 的 应 用 开发 时 有 非常 大 的 优势 ， 但 从 工程 化 的 角度 
考虑 ， 它 即使 结合 JavaBeans 技术 后 还 是 有 一 些 不 足 之 处 : 
口 应 用 的 实现 一 般 是 基于 过 程 的 , 一 组 JSP 页 面 实现 一 个 业务 流程 , 如 果 要 进行 改动 ， 
必须 在 多 个 地 方 进行 修改 。 这 样 非常 不 利于 应 用 扩展 和 更 新 。 
口 由 于 应 用 不 是 建立 在 模块 上 的 , 业务 罗 辑 和 表示 届 辑 混合 在 JSP 页 面 中 没有 进行 抽 
象 和 分 离 ， 所 以 非常 不 利于 应 用 系统 业务 的 重用 和 改动 。 
考虑 到 这 些 问题 ， 在 开发 大 型 的 Web 应 用 时 必须 采用 不 同 的 设计 模式 一 一 Model 2。 


18.2.2 ”MVC 设计 模式 (Model 2) 


模型 一 视图 一 控制 器 (MVC) 是 Xerox PARC 在 20 世纪 80 年 代为 编程 语言 Smalltalk 
一 80 发 明 的 一 种 软件 设计 模式 , 最 近 几 年 被 推荐 为 Sun 公司 J2EE 平台 的 设计 模式 , 并且 受 
到 越 来 越 多 的 使 用 ColdFusion 和 PHP 的 开发 者 的 欢迎 。MVC 设计 模式 包括 3 类 对 象 : 

口 模型 (Model) 对 象 :是 应 用 程序 的 主体 部 分 。 

口 视图 (View) 对 象 : 是 应 用 程序 中 负责 生成 用 户 界面 的 部 分 。 

口 控制 器 (Controller) 对 象 : 是 根据 用 户 的 输入 , 控制 用 户 界面 数据 显示 及 更 新 Model 

对 象 状态 的 部 分 。 下 面 介绍 它们 之 间 的 关系 和 各 自 的 主要 功能 。 

视图 (View) 代 表 用 户 交互 界面 ,对 于 Web 应 用 来 说 ,可 以 概括 为 HTML 界面 .XHTML、 
XML 和 Applet。MYVC 设计 模式 对 于 视图 的 处 理 仅 限于 视图 上 数据 的 采集 和 处 理 ， 以 及 用 
户 的 请 求 , 而 不 包括 在 视图 上 的 业务 流程 的 处 理 。 业 务 流程 的 处 理 交 给 模型 (Model) 处 理 。 
比如 一 个 订单 的 视图 只 接受 来 自 模型 的 数据 并 显示 给 用 户 ， 以 及 将 用 户 界 面 的 输入 数据 和 
请 求 传递 给 控制 和 模型 ，MVC 设计 模式 基本 结构 如 图 18.3 所 示 。 
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Controller 接收 用 户 请 | 业务 处 理 
求 并 传 到 Model， 并 选 
择 合适 的 View 


Model， 业 务 流程 处 
理 、 业 务 状态 改变 


View， 用 户 界 面 信 
息 , 与 用 户 交 互 , 请 
求 Model 


图 18.3 MVC 设计 模式 基本 结构 


模型 (Mode) 就 是 业务 流程 /状态 的 处 理 以 及 业务 规则 的 指定 。 业 务 流程 的 处 理 过 程 对 
其 他 层 来 说 是 黑箱 操作 ， 模 型 接收 视图 请 求 的 数据 ， 并 返回 最 终 的 处 理 结果 。 业 务 模型 的 
设计 可 以 说 是 MVC 最 主要 的 核心 。 

业务 模型 还 有 一 个 很 重要 的 模型 就 是 数据 模型 。 数 据 模型 主要 指 实体 对 象 的 数据 保存 
(持续 化 )。 比 如 将 一 张 订单 保存 到 数据 库 ， 从 数据 库 获 取 订 单 。 可 以 将 这 个 模型 单独 列 
出 ， 所 有 有 关 数 据 库 的 操作 只 限制 在 该 模型 中 。 

控制 Controller) 从 用 户 接收 请 求 ， 将 模型 与 视图 匹配 在 一 起 ， 共 同 完成 用 户 的 请 求 。 划 
分 控制 层 的 作用 也 很 明显 ， 它 就 是 一 个 分 发 器 ， 选 择 什么 样 的 模型 ， 选 择 什么 样 的 视图 ， 可 以 
完成 什么 样 的 用 户 请 求 。 控 制 层 并 不 作 任 何 的 数据 处 理 。 例 如 ， 用 户 单 击 一 个 连接 ， 控 制 层 接 
受 请 求 后 ， 并 不 处 理 业务 信息 ， 它 只 把 用 户 的 信息 传递 给 模型 ， 告 诉 模型 做 什么 ， 选 择 符合 要 
求 的 视图 返回 给 用 户 。 因 此 ， 一 个 模型 可 能 对 应 多 个 视图 ， 一 个 视图 可 能 对 应 多 个 模型 。 

MVC 模式 不 仅 实现 了 功能 模块 和 显示 模块 的 分 离 ， 同 时 它 还 提高 了 应 用 系统 的 可 维护 
性 、 可 扩展 性 、 可 移植 性 和 组 件 的 可 复 用 性 。 


18.3 Web 应 用 的 架构 框架 


随 着 网 络 应 用 的 快速 增加 , MVC 模式 对 于 Web 应 用 的 开发 无 疑 是 一 种 非常 先进 的 设计 
思想 ， 无 论 选择 哪 种 语言 ， 无 论 应 用 多 复杂 ， 它 都 能 在 理解 分 析 应 用 模型 时 提供 最 基本 的 
分 析 方 法 ， 构 造 产品 提供 清晰 的 设计 框架 ， 为 软件 工程 提供 规范 的 依据 。 

现在 已 经 有 了 很 多 的 MVC 模式 ， 例 如 Struts、Tapestry、WebWork2 等 ， 不 同 的 实现 在 
具体 的 策略 上 当然 是 有 所 不 同 ， 本 节 将 简单 介绍 几 个 MVC 模式 的 实现 , 在 后 面 的 章节 中 还 
会 继续 介绍 如 何 使 用 它们 进行 开发 。 


18.3.1 Struts 一 一 最 流行 的 MVC 框架 


Struts 是 Apache Jakarta 项 目的 组 成 部 分 。 该 项 目的 目标 是 为 建立 Java Web 应 用 程序 而 
提供 的 一 个 开源 框架 ,目前 一 般 使 用 的 版 本 为 1.1， 最 新 版 本 是 1.2。 通 过 使 用 Struts 框架 可 
以 改进 和 提高 Java Server Pages (JSP) 、Servlet、 标 签 库 以 及 面向 对 象 的 技术 在 Web 应 用 


“332 。 JSP 网 络 开发 技术 及 整合 应 用 


程序 中 的 应 用 。 应 用 Struts 框架 可 以 减少 应 用 MVC (Model-View-Controller) 设计 模式 的 开 
发 时 间 ， 从 而 提高 开发 效率 。 

Struts 是 MVC 的 一 种 实现 ， 它 很 好 地 结合 了 Jsp、Java Servlet、JavaBeans 和 Taglib 等 
技术 ， 是 MVC 模式 的 经 典 实现 。 


18.3.2 WebWork2 一 一 基于 XWork 的 MVC 框架 


WebWork 是 由 OpenSymphony 组 织 开 发 的 ,是 致力 于 组 件 化 和 代码 重用 的 拉 出 式 MVC 
模式 2EE Web 框架 。WebWork 目前 最 新 版 本 是 2.1， 现 在 的 WebWork2.x 前 身 是 Rickard 
Oberg 开发 的 WebWork。WebWork2 建立 在 XWork 之 上 处 理 HTTP 的 响应 和 请 求 。 


18.3.3 ”Spring 一 一 以 控制 倒置 原则 为 基础 的 MVC 框架 


Spring 是 一 个 以 控制 倒置 (Inversion of Control) 原则 为 基础 的 轻 量 级 框架 。 控 制 倒置 
是 一 个 用 于 “基于 组 件 的 体系 结构 ”的 设计 模式 ， 它 将 “判断 依赖 关系 ”的 职责 移交 给 容 
器 ， 而 不 是 由 组 件 本 身 来 判断 彼此 之 间 的 依赖 关系 。 当 在 Spring 内 实现 组 件 时 ， 容 器 “ 轻 
量 级 ”的 方面 就 展现 出 来 了 : 针对 Spring 开发 的 组 件 不 需要 任何 外 部 库 ， 而 且 ， 容 器 是 轻 
量 级 的 ， 它 避免 了 像 EJB 容器 那样 的 重量 级 方案 的 主要 缺点 ， 例 如 启动 时 间 长 、 测 试 复杂 、 
部 署 和 配置 困难 等 。 
18.3.4 ”Java Server Faces 一 一 Sun 力 推 的 MVC 框架 

Java Server Faces (JSF) 是 一 种 MVC 应 用 程序 框架 ， 用 于 创建 基于 Web 的 用 户 界面 。 
如 果 读 者 熟悉 Struts (一 种 流行 的 开放 源 代码 的 基于 JSP 的 Web 应 用 程序 框架 ) 和 Swing 
(针对 桌面 应 用 程序 的 标准 Java 用 户 界面 ) ， 就 可 以 将 Java Server Faces 想象 成 这 两 种 框 


架 的 组 合 。 与 Struts 一 样 , JSF 通过 一 个 控制 器 Servlet 来 提供 Web 应 用 程序 生命 周期 管理 ; 
也 与 Swing 一 样 ，JSF 提供 了 一 个 带 有 事件 处 理 和 组 件 呈 现 〈rendering) 的 丰富 组 件 模型 。 


18.4 Web 应 用 的 测试 


在 一 个 软件 开发 项 目 中 ， 软 件 的 测试 是 一 个 必 不 可 少 的 工作 ， 为 了 保证 工程 的 质量 需 
要 ， 对 软件 进行 的 测试 有 : 功能 测试 、 性 能 测试 、 安 全 性 测试 、 稳 定性 测试 、 浏 览 器 兼容 
性 测试 等 多 项 测试 。 其 中 功能 测试 又 是 最 基本 的 一 项 测试 ， 它 是 其 他 测试 的 基础 。 

18.4.1 _ JUnit 一 一 优秀 的 单元 测试 工具 


对 于 Java 程序 而 言 , JUnit 是 一 个 非常 优秀 的 单元 测试 工具 , 可 以 进行 有 效 的 功能 测试 ， 


第 18 章 JSP Web 应 用 的 设计 概述 “333。 
JUnit 是 当前 Java 语言 单元 测试 的 一 站 式 解 决 方案 ， 它 把 测试 驱动 的 开发 思想 介绍 给 Java 


开发 人 员 并 教 给 他 们 如 何 有 效 地 编写 单元 测试 。 众 多 的 优点 使 得 它 成 为 一 种 优秀 的 测试 工 
具 ， 在 本 章 就 介绍 如 何 使 用 JUnit 进行 Java 的 单元 测试 。 


18.4.2 ” ”Cactus 一 一 基于 JUnit 框架 的 服务 器 端 测 试 工具 


Cactus 是 一 个 基于 JUnit 框架 的 简单 测试 框架 ， 用 来 单元 测试 服务 端 Java 代码 。Cactus 
框架 的 主要 目标 是 能 够 单元 测试 服务 端的 使 用 Servlet 对 象 的 Java 方法 ， 如 HttpServlet 
Request、HttpServletResponse、HttpSession 等 。 


18.5 目 志 


18.5.1 Log4j 一 一 最 流行 的 日 志 工 具 


Log4j 是 Apache 的 一 个 开放 源 代码 项 目 , 通过 使 用 Log4j， 可 以 控制 日 志 信息 输送 的 目 
的 地 是 控制 台 、 文 件 、GUI 组 件 ， 甚 至 是 套 接口 服务 器 、NT 的 事件 记录 器 、UNIX Syslog 
守护 进程 等 ， 可 以 控制 每 一 条 日 志 的 输出 格式 ， 通 过 定义 每 一 条 日 志 信息 的 级 别 ， 能 够 更 
加 细致 地 控制 日 志 的 生成 过 程 。 最 重要 的 是 这 些 可 以 通过 一 个 配置 文件 来 灵活 地 进行 配置 ， 
而 不 需要 修改 应 用 的 代码 。 


18.5.2 Jakarta Commons Logging 一 一 Jakarta 的 优秀 日 志 工 具 


Jakarta Commons Logging (JCL) 提供 的 是 一 个 日 志 (Log) 接口 〈Interface) ， 同 时 
兼顾 轻 量 级 和 不 依赖 于 具体 的 日 志 实 现 工具 。 它 提供 给 中 间 件 /日 志 工 具 开 发 者 一 个 简单 
的 日 志 操作 抽象 ， 允 许 程序 开发 人 员 使 用 不 同 的 具体 日 志 实现 工具 。 用 户 被 假定 已 熟悉 某 
种 日 志 实现 工具 的 更 高 级 别 的 细节 。JCL 提供 的 接口 对 其 他 一 些 日 志 工具 ， 包 括 Log4j、 
Avalon LogKit 和 JDK 1.4 等 , 进行 了 简单 的 包装 , 此 接口 更 接近 于 Log4j 和 LogKit 的 实现 。 


18.6 人 小 结 


Web 应 用 的 设计 是 Web 开发 一 个 很 重要 的 环节 ， 如 果 设计 不 好 ， 就 会 前 功 尽 弃 ， 而 现 
在 的 Web 开发 也 变 得 负责 起 来 ， 对 于 开发 时 选择 什么 样 的 框架 结构 ， 使 用 什么 样 的 测试 工 
具 ， 如 何 记录 日 志 信 息 等 都 是 需要 事先 考虑 清楚 的 ， 在 本 章 中 介绍 一 些 常用 的 相关 工具 ， 
在 这 里 只 是 简单 的 介绍 ， 有 具体 如 何 使 用 在 后 面 的 章节 都 会 有 详细 的 介绍 。 
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Struts 是 MVC 的 一 种 实现 ， 它 很 好 地 结合 了 JSP、Java Servlet、JavaBeans、Taglib 等 
技术 。Struts 已 经 成 为 了 用 Java 创建 Web 应 用 的 一 个 最 流行 的 框架 工具 ，Struts 所 实现 的 
MVC 模式 给 Web 应 用 带 来 了 良好 的 层次 划分 ， 同 时 也 提供 了 一 系列 的 工具 来 简化 Web 应 
用 的 开发 ， 成 为 基于 MVC 模式 的 Web 应 用 最 经 典 的 框架 。 


19.1 快速 体验 Struts 一 一 使 用 Struts 框架 的 简单 应 用 实例 


19.1.1 建立 Struts 开发 环境 


要 使 用 Struts 创建 Web 应 用 ， 需 要 下 载 安装 支持 Struts 的 JAR 文件 ， 并 把 它 放 到 Web 
应 用 的 lib 目录 下 ， 这 些 文件 可 以 从 其 官方 网 站 http://struts.apache.org/ 上 免费 下 载 ， 最 新 版 
本 是 1.2.7, 下 载 其 二 进 制 版 本 struts-1.2.7.zip 后 , 按照 如 下 步骤 建立 发 布 第 一 个 Struts 应 用 。 

(1) 将 struts-1.2.7.zip 解压 缩 到 本 地 硬盘 ， 设 定 解压 后 的 目录 为 <Strust_HOME>。 

(2) 把 <Strust HOME>\webapps\struts-examples.war 文件 复制 到 <TOMCAT_HOME> 
\webapps 目录 下 。 

(3) 重新 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/struts 
-examples/。 可 以 看 到 页 面 显示 如 图 19.1 所 示 。 


EW 3 下 了 
Om AO wm Wm OE: sa J 明 仿 加 
HE | tp yiloeahvat S000/ srot serieples/vel cone 由 EIE TE 
Struts Examples 

Each of these links lead to a scparate ‘module" within this application 


‘These modnles follow the "eamn by example" school Be sure to ‘look under the hood" to see how t's done 


Taglib Test Pages 


These pages are designed to test the operalion of the various taglbs that come bundied wah Stus you examire | 
[SE [ml 有 4 


图 19.1 发 布 第 一 个 Struts 应 用 


看 起 来 ，Struts 的 应 用 还 是 很 容易 发 布 的 。 其 实 要 使 用 Struts 创建 Web 应 用 关键 需要 
<Strust_ HOME>\lib 目录 下 的 如 下 JAR 文件 的 支持 : 
口 antlrjar 
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commons-beanutils.jar 
commons-digester.jar 
commons-validator.jar 


jakarta-oro.jar 


DOOODODOCDO 


Struts.jar 

这 些 JAR 文件 是 编译 ActionServlet、Action 等 Struts 关键 组 建 的 必需 包 , 所 以 需要 把 这 
些 文件 加 入 到 classpath 中 ， 用 于 编译 Struts 应 用 的 Java 类 文件 ， 同 时 ， 在 发 布 应 用 时 ， 还 
应 该 把 这 个 文件 复制 到 该 应 用 的 WEB-INF\lib 目录 下 , 以 为 Web 应 用 程序 的 运行 提供 支持 。 


19.1.2 ”实例 介绍 
在 本 小 节 介绍 一 个 简单 的 例子 ， 在 这 个 例子 中 ， 可 以 通过 超 链接 和 表单 提交 的 方式 访 


问 在 配置 文件 中 配置 的 视图 。 
使 用 表单 提交 的 方式 访问 视图 的 流程 如 图 19.2 所 示 。 


图 19.2 使 用 表单 提交 的 方式 访问 视图 的 流程 
使 用 超 链接 的 方式 访问 视图 就 比较 简单 了 ， 与 普通 的 超 链 接 是 一 样 的 ， 这 里 就 不 介绍 了 。 


19.1.3 创建 Model 组 件 


Model 就 是 在 对 用 户 请 求 的 整个 控制 过 程 中 ， 真 正 处 理 用 户 请 求 并 保存 处 理 结 果 的 对 
象 ， 在 整个 过 程 中 ， 一 般 用 JavaBeans 把 一 些 信息 保存 起 来 以 便 在 各 个 对 象 之 间 传 递 。 因 为 
在 MVC 框架 中 ，Model 对 象 是 真正 处 理 商 业 逻 辑 功能 的 对 象 ， 因 此 也 就 是 框架 中 应 用 需求 
实现 相关 性 最 大 的 部 分 。 

在 Struts 的 实现 里 ，Model 的 具体 表现 形式 就 是 ActionForm 对 象 和 与 其 对 应 的 Action 
对 象 了 。 对 用 户 提交 表单 的 数据 进行 校 验 ， 甚 至 对 数据 进行 预 处 理 都 能 在 ActionForm 中 完 
成 。 通 常 的 应 用 中 ,一般 是 一 个 Model 对 象 和 一 个 请 求 页 面 对 应 的 关系 ,但 也 可 以 一 个 Model 
对 象 对 应 多 个 页 面 请 求 。 如 果 struts-config.xml 配置 文件 没有 指定 一 个 Model 对 象 对 应 的 
Action, 那么 控制 器 将 直接 把 (通过 Model 对 象 完成 数据 封装 的 ) 请 求 转 到 一 个 View 对 象 。 


“336。 JSP 网 络 开发 技术 及 整合 应 用 


在 这 个 例子 中 ， 为 了 简化 ， 没 有 使 用 ActionForm 对 象 的 验证 方法 ， 开 发 者 可 以 在 
ActionForm 的 validate 方法 中 对 用 户 的 输入 进行 验证 ， 用 户 如 果 要 尝试 如 何在 ActionForm 
中 对 自己 的 数据 进行 验证 ， 可 以 自己 添加 这 个 方法 。 完 整 的 代码 (GetParameterForm.java) 
如 下 : 


package cn.ac.ict; 
import org.apache.struts.action.ActionForm; 


public class GetParameterForm extends ActionForm{ 
// 一 个 属性 值 


private String valu="null"; 
public GetParameterForm() { 


} 
// 设 置 和 获取 属性 值 的 方法 

public void setValu(String s) { 
valu=s; 
} 

public String getValu() { 
return valu; 
} 
} 


除了 ActionForm 外 ， 还 需要 一 个 Action 对 象 ， 像 上 面 说 的 那样 ，Action 是 和 应 用 需求 
实现 相关 性 很 大 的 ， 它 真正 处 理 商 业 逻 辑 功 能 ， 代 码 (ShowActionjava) 如 下 : 


package cn.ac.ict; 


import java.lang.reflect.InvocationTargetException; 
import java.util.Locale; 

import javax.servlet.ServletException; 

import javax.servlet.http.HttpServletRequest'; 
import javax.servlet.http.HttpSession; 

import javax.servlet.http. HttpServletResponse; 
import org.apache.struts.action.*; 

import org.apache.struts.util.*; 


public final class ShowAction extends Action{ 
/定义 execute 方法 
public ActionForward execute(ActionMapping mapping,ActionForm form, 
HttpServletRequest request, HttpServletResponse response) 

throws Exception { 
Locale locale = getLocale(request); 
MessageResources messages = getResources(request); 
HttpSession session = request.getSession(); 
GetParameterForm userform = (GetParameterForm) form; 

/判断 用 户 的 输入 信息 ， 并 转发 到 不 同 的 页 面 

if(userform.getValu().equals("success")) { 

return(mapping.findForward("success")); 
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jelse{ 
System.out.println(userform.getValu()); 
return(mapping.findForward("fail")); 
} 


L 
在 这 个 类 中 只 有 一 个 方法 execute， 它 获得 用 户 的 请 求 信息 ， 得 到 用 户 输入 的 字符 串 ， 
并 判断 是 success 还 是 fail， 如 果 是 success 就 转发 到 success 视图 (在 配置 文件 中 配置 ， 对 
应 success.jsp) ， 如 果 是 fail 就 转发 到 fail 视图 (在 配置 文件 中 配置 ， 对 应 failjsp) 。 


19.1.4 创建 View 组 件 


根据 上 面 的 实例 介绍 ， 可 以 了 解 到 在 本 实例 中 涉及 4 个 JSP 文件 (还 需要 一 个 提供 用 
户 输入 的 页 面 )， 分 别 是 index.jsp、successjsp、failjsp 和 error.jsp， 在 这 里 它们 都 是 非常 简 
单 的 ， 只 是 简单 地 输出 一 个 字符 串 ， 它 们 的 代码 如 下 : 

1. 编写 index.jsp 文件 


<%@ page contentType="text/html;charset=gb2312"%> 
<%@ page import="java.util.*,java.sql.*,java.text.*,java.io.*"%> 


<form name="form1" method="post" action="showinput.do"> 

输入 success 将 返回 到 "success" 页 面 ， 否 则 返回 到 "fail" 页 面 <br><br> 
input:<input type="text" name="valu"> <input type="submit" value="submit"> 
</form> 

<br> 

<a href="success.do">success</a><br> 

<a href="fail.do">fail</a> 

2. 编写 success.jsp 

<%@ page contentType="text/html;charset=gb2312"%> 


<%@ page import="java.util.*,java.sql.*,java.text.*,java.io.*"%> 
success! 

3. 编写 fail.jsp 

<%@ page contentType="text/html;charset=gb2312"%> 

<%@ page import="java.util.*,java.sql.*,java.text.*,java.io.*"%> 
fail! 


4. 编写 error.jsp 


<%@ page contentType="text/html;charset=gb2312"%> 
<%@ page import="java.util.*,java.sql.*,java.text.*,java.io.*"%> 


error pagel 
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19.1.5 ”编写 配置 文件 


Struts 的 配置 文件 定义 了 全 局 转发 、ActionMapping 类 、ActionForm Bean 和 JDBC 数据 
源 4 个 部 分 ， 在 本 实例 中 只 需要 配置 前 3 种 就 可 以 了 ， 下 面 是 配置 文件 的 完整 代码 : 


<?xml version="1.0" encoding="ISO-8859-1" ?> 
<!DOCTYPE struts-config PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" 
"http:Wiakarta.apache.org/struts/dtds/struts-config 1 1.dtd"> 
<struts-config> 
<!- == === 定义 Form Beans = 
<form-beans> 
<form-bean name="GetParameterForm" type="cn.ac.ict.GetParameterForm"/> 
</form-beans> 


<global-forwards> 
<forward name="success" path="/success.do"/> 
<forward name="fail" path="/fail.do"/> 
</global-forwards> 


<!-- ========== 定义 Action 映射 ============================== --> 
<action-mappings> 
<action 
path="/success" 
type="org.apache.struts.actions.ForwardAction” 
parameter="/success.jsp"/> 
<action 
path="/fail" 
type="org.apache.struts.actions.ForwardAction” 
parameter="/fail.jsp"/> 
<action path="/showinput" 
type="cn.ac.ict.ShowAction" 
name="GetParameterForm" 
scope="request”" 
input="/index.jsp" > 
<forward 
name="success" 
path="/success.jsp"/> 
<forward 
name="fail" 
path="/fail.jsp"/> 
</action> 
</action-mappings> 


</struts-config> 
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具体 元 素 的 意义 将 在 后 面 的 章节 介绍 。 

这 是 Struts 运行 必需 的 一 个 配置 文件 ， 但 除 此 之 外 , 还 需要 在 web.xml 文件 中 配置 使 用 
控制 器 组 件 ， 一 般 控 制 器 组 建 是 Struts 包 中 提供 的 org.apache.struts.action.ActionServlet， 
web.xml 文件 的 完整 代码 如 下 : 

<?xml version="1.0" encoding="ISO-8859-1"?> 

<web-app xmlns="http:Wiava.sun.com/xmlns/j2ee” 

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance” 
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee 
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" 
version="2.4"> 
<display-name>Simple Struts Application</display-name> 
<Servlet> 
<Sservlet-name>action</servlet-name> 
<Servlet-class>org.apache.struts.action.ActionServlet</servlet-class> 
</servlet> 


<!-- Action Servlet 映射 -> 
<servlet-mapping> 
<Sservlet-name>action</servlet-name> 
<url-pattern>*.do</url-pattern> 
</servlet-mapping> 


<!-- 欢迎 文件 列表 --> 
<welcome-file-list> 
<welcome-file>index.jsp</welcome-file> 
</welcome-file-list> 


</web-app> 
全 注意 : 配置 文件 中 不 能 包含 中 文 注释 ， 否 则 是 无 法 识别 的 。 


19.1.6 ”发布 运行 Web 应 用 


上 述 文 件 都 准备 好 后 ， 可 以 按照 如 下 步骤 发 布 Web 应 用 : 
(1) 编译 ActionForm 和 Action 的 实现 类 ， 编 译 时 ， 需 要 把 Struts 的 支持 包 加 入 到 类 
路 径 中 ， 把 编译 后 的 字 节 码 文件 复制 到 Web 应 用 的 WEB-INF\classes 目录 下 ， 存 放 的 目录 
层次 和 包 的 层次 是 一 致 的 ， 此 时 Web 应 用 的 目录 结构 如 图 19.3 所 示 。 
(2) 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/19/index.jsp， 
可 以 看 到 页 面 显 示 如 图 19.4 所 示 。 
当 在 页 面 中 输入 success 或 者 单 击 下 面 的 success 链接 时 就 会 转向 success.do 页 面 , 也 就 
是 successjsp， 页 面 显示 如 图 19.5 所 示 。 
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图 19.3 ”Web 应 用 的 目录 结构 图 19.4 用 户 输入 界面 


图 19.5 ”success.do 页 面 


19.2 ”Struts 框架 的 体系 结构 与 运行 原理 


Struts 是 Apache Jakarta 项 目的 组 成 部 分 。 该 项 目的 目标 是 为 建立 Java Web 应 用 程序 而 
提供 的 一 个 开源 框架 ， 目 前 一 般 使 用 的 版 本 为 1.1， 最 新 版 本 是 1.2。 通 过 使 用 Struts 框架 可 
以 改进 和 提高 Java Server Pages (JSP) 、Servlet、 标 签 库 以 及 面向 对 象 的 技术 在 Web 应 用 
程序 中 的 应 用 。 应 用 Struts 框架 可 以 减少 应 用 MVC (Model-View-Controller) 设计 模式 的 开 
发 时 间 ， 从 而 提高 开发 效率 。 

Struts 是 MVC 的 一 种 实现 ， 它 很 好 地 结合 了 Jsp、Java Servlet、JavaBeans 和 Taglib 等 
技术 。 下 面 从 MVC 角度 谈 谈 Struts 框架 体系 结构 和 工作 原理 , 并 解释 一 下 Struts 配置 文件 ， 
用 于 使 用 Struts 开发 Web 应 用 。 


19.2.1 ”从 Struts 的 组 件 来 看 Struts 的 工作 原理 


如 图 19.6 所 示 是 Struts 框架 的 体系 结构 。 

(1) 控制 器 : 在 Struts 中 ，ActionServlet 起 着 一 个 控制 器 (Controller〉 的 作用 。 
ActionServlet 是 一 个 通用 的 控制 组 件 。 这 个 控制 组 件 提供 了 处 理 所 有 发 送 到 Struts 的 HTTP 
请 求 的 入 口 点 。 它 截取 和 分 发 这 些 请 求 到 相应 的 动作 类 (这 些 动作 类 都 是 Action 类 的 子 类 )。 
另外 控制 组 件 也 负责 用 相应 的 请 求 参 数 填充 ActionForm (通常 称 之 为 FormBean) ， 并 传 给 
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动作 类 (通常 称 之 为 ActionBean) 。 动 作 类 实现 核心 商业 逻辑 ， 它 可 以 访问 JavaBeans 或 调 
] EJB。 所 有 这 些 控制 逻辑 利用 Struts-config.xml 文件 来 配置 。 


守 模 型 

状态 查询 | 封装 应 用 程序 状态 
响应 状态 查询 

| 应 用 程序 功能 
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一 一 一 方法 调用 --------! > 事件 
图 19.6 Struts 的 体系 结构 
(2) 视图 :主要 是 由 JSP 来 控制 页 面 输出 的 。 它 接收 到 ActionForm 中 的 数据 ， 利 用 
HTML、Taglib、Bean、Logic 等 显示 数据 。 
(3) 模型 : 在 Struts 中 ， 主 要 存在 3 种 Bean， 分 别 是 : Action、ActionForm、EJB 或 


者 JavaBeans。ActionForm 用 来 封装 客户 请 求 信息 ，Action 取得 ActionForm 中 的 数据 ， 再 
由 EJB 或 者 JavaBeans 进行 处 理 。 


如 图 19.7 所 示 是 Struts 体系 结构 中 的 组 件 图 ， 下 面 就 结合 图 19.6 讲解 Struts 的 具体 构成 。 
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图 19.7 Struts 体系 结构 中 的 组 件 
图 19.7 显示 了 ActionServlet (Controller) 、ActionForm (Form State) 和 Action (Model 
Wrapper) 之 间 的 最 简 关 系 。 体 系 结构 中 所 使 用 的 组 件 如 表 19.1 所 示 。 
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表 19.1 Struts 体系 结构 中 所 使 用 的 组 件 


组 件 名 称 组 件 所 起 的 作用 
ActionServlet 控制 器 

ActionClass 包含 事务 逻辑 

ActionForm 显示 模块 数据 

ActionMapping 帮助 控制 器 将 请 求 映射 到 操作 
ActionForward 来 指示 操作 转移 的 对 象 
ActionError 来 存储 和 回收 错误 

Struts 标 记 库 可 以 减轻 开发 显示 层次 的 工作 


19.2.2 Struts 配置 文件 struts-config.xml 


struts-config.xml 是 Struts 的 配置 文件 ， 文 件 的 配置 包括 全 局 转发 、ActionMapping 类 、 
ActionForm Bean 和 JDBC 数据 源 4 个 部 分 。 

1. 配置 全 局 转发 

全 局 转发 用 来 在 JSP 页 面 之 间 创 建 逻辑 名 称 映射 。 转 发 都 可 以 通过 对 调用 操作 映射 的 
实例 来 获得 ， 例 如 : 

actionMappinglInstace.findForward("logicalName"); 

下 面 是 全 局 转发 的 例子 : 


<global-forwards> 

// 其 中 全 局 转发 的 名 字 是 bookCreated， 转 发 的 目标 路 径 是 /BookView.jsp 
<forward name="bookCreated" path="/BookView.jsp"/> 

</global-forwards> 


2. 配置 ActionMapping 

ActionMapping 对 象 帮助 进行 框架 内 部 的 流程 控制 ， 它 们 可 将 请 求 URI 映射 到 Action 
类 ， 并且 将 Action 类 与 ActionForm Bean 相关 联 。ActionServlet 在 内 部 使 用 这 些 映射 ， 并 将 
控制 转移 到 特定 Action 类 的 实例 。 所 有 Action 类 使 用 perform() 方 法 实现 特定 应 用 程序 代 
码 ， 返 回 一 个 ActionForward 对 象 ， 其 中 包括 响应 转发 的 目标 资源 名 称 。ActionMapping 的 
属性 如 表 19.2 所 示 。 下 面 是 一 个 例子 : 

<action-mappings> 

<action path="/createBook" type="BookAction" name="bookForm" scope="request" input= "/Create 

Book.jsp"> 

</action> 

<forward name="failure" path="/CreateBook.jsp"/> 


<forward name="cancel" path="/index.jsp"/> 
</action-mappings> 


第 19 章 MVC 模式 实现 一 一 Struts “343 。 


表 19.2 ActionMapping 的 属性 


属 性 描述 
path Action 类 的 相对 路 径 

name 与 本 操作 关联 的 Action Bean 的 名 称 

type 连接 到 本 映射 的 Action 类 的 全 称 〈 要 有 包 名 ) 
scope ActionForm Bean 的 作用 域 (请 求 或 会 话 ) 

prefix 用 来 匹配 请 求 参数 与 Bean 属 性 的 前 组 


suffix 用 来 匹配 请 数 与 Bean 属 性 的 后 级 
attribute, 作用 域名 称 
className | ActionMapping 对 象 的 类 的 完全 限定 名 ， 默 认 的 类 是 org.apache.struts.action.ActionMapping 
input 输入 表单 的 路 径 ， 指 向 Bean 发 生 输入 错误 必须 返回 的 控制 
unknown 设 为 tue， 操 作 将 被 作为 所 有 没有 定义 的 ActionMapping 的 URI 的 默认 操作 
设置 为 tue， 则 在 调用 Action 对 象 上 的 perform() 方 法 前 ，ActionServlet 将 调用 ActionForm 
Bean 的 validate0 方 法 来 进行 输入 检查 


通过 <forward> 元 素 可 以 定义 资源 的 逻辑 名 称 , 该 资源 是 Action 类 的 响应 要 转发 的 目标 ， 
forward 属性 如 表 19.3 所 示 。 


validate 


表 19.3 forward 属 性 


属 性 描述 
id ID 
className ActionForward 类 的 完全 限定 名 ， 默 认 是 org.apache.struts.action.ActionForward 
name 操作 类 访问 ActionForward 时 所 用 的 逻辑 名 
path 响应 转发 的 目标 资源 的 路 径 
redirect 车 设置 为 tue， 则 ActionServlet 使 用 sendRedirect0 方 法 来 转发 资源 


3. 配置 ActionForm Bean 

ActionServlet 使 用 ActionForm 来 保存 请 求 的 参数 , 这 些 Bean 的 属性 名 称 与 HTTP 请 求 
参数 中 的 名 称 相 对 应 ， 控 制 器 将 请 求 参数 传递 到 ActionForm Bean 的 实例 ， 然 后 将 这 个 实例 
传送 到 Action 类 。ActionForm Bean 的 属性 如 表 19.4 所 示 。 下 面 是 一 个 配置 ActionForm Bean 
的 例子 : 

<form-beans> 


<form-bean name="bookForm" type="BookForm"/> 
</form-beans> 


表 19.4 配置 ActionForm Bean 的 属性 


属 性 描述 

id ID 

className | ActionForm Bean 的 完全 限定 名 ， 默 认 值 是 org.apache.struts.action.ActionFormBean 
name | 表单 Bean 在 相关 作用 域 的 名 称 ， 这 个 属性 用 来 将 Bean 与 ActionMapping 进 行 关联 


Je 类 的 完全 限定 名 
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4. 配置 JDBC 数据 源 
及 <data-sources> 元 素 可 以 定义 多 个 数据 源 ， 其 所 具有 的 属性 如 表 19.5 所 示 。 


表 19.5 data-sources 的 属性 


属 性 描述 
id ID 
key Action 类 使 用 这 个 名 称 来 寻找 连接 
type 实现 JDBC 接 口 的 类 的 名 称 


这 些 属性 还 不 足以 定义 一 个 完整 的 数据 源 ， 其 他 的 属性 需要 子 元 素 <set-property> 定 义 

(set-property 的 属性 如 表 19.6 所 示 ), 在 Struts 1.1 版 本 中 已 不 再 使 用 , 但 仍 可 用 <data-source> 
元 素 。 例 如 : 

<data-sources> 

<data-source id="DS1" key="conPool" type="org.apache.struts.util.GenericDataSource" 

<set-property id="SP1" autoCommit= "true" description="Example Data Source Configuration 

driverClass="org.test.mm.mysql.Driver" maxCount="4" 

minCount="2" url="jdbc:mysql://localhost/test" user="struts" password="ghq123" /> 

<data-source/> 

</data-sources> 


表 19.6 set-property 的 属性 


属 性 描述 
description 数据 源 的 描述 
autoCommit 数据 源 创建 的 连接 所 使 用 的 默认 自动 更 新 数据 库 模式 
driverClass 数据 源 所 使 用 的 类 ， 用 来 显示 JDBC 驱 动 程序 接口 
loginTimeout 数据 库 登 录 时 间 的 限制 ， 以 秒 为 单位 
maxCount 最 多 能 建立 的 连接 数目 
minCount 要 创建 的 最 少 连接 数目 
password 数据 库 密 码 
readOnl 创建 只 读 的 连接 
user 访问 数据 库 的 用 户 名 
url JDBC 的 URL 


通过 指定 关键 字 名 称 ，Action 类 可 以 访问 数据 源 ， 例 如 : 
javax.sql.DataSource ds = servlet.findDataSource("conPool"); 
javax.sql.Connection con = ds.getConnection(); 


19.3 Struts 组 件 介 绍 


19.3.1 使 用 ActionServlet 控制 器 类 分 发 请 求 


Struts 控制 器 组 件 负责 接收 用 户 的 请 求 、 更 新 模型 以 及 选择 合适 的 视图 组 件 返回 给 客户 
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端 。 控 制 器 组 件 有 助 于 将 模型 和 视图 分 离 ， 有 了 这 种 分 离 可 以 在 同一 个 模型 的 基础 上 得 心 
应 手 地 开发 多 种 模型 的 视图 。 

Struts 控制 器 组 件 主要 包括 ActionServlet 框架 中 央 控 制 器 、RequestProcessor 每 个 子 应 
用 的 模块 处 理 器 ，ActionServlet 负责 处 理 具体 的 业务 的 组 件 。Struts 采用 ActionServlet 和 
RequestProcessor 组 件 进行 集中 控制 ， 并 且 采 用 Action 组 件 来 完成 具体 的 业务 单项 处 理 。 控 
制 器 组 件 的 控制 机 制 主 要 是 接受 用 户 请 求 ， 根 据 用 户 的 请 求 调用 合适 的 模型 来 执行 业务 逻 
辑 ， 获 取 业 务 逻 辑 的 结果 ， 根 据 当 前 状态 以 及 业务 逻辑 执行 结果 选择 合适 的 视图 组 件 返 回 
给 客户 端 。 

ActionServlet 继承 自 javax.servlet.http.HttpServlet 类 , 其 在 Struts 中 扮演 的 角色 是 中 心 控 
制 器 。 它 提供 一 个 中 心 位 置 来 处 理 全 部 的 终端 请 求 。 控制 器 ActionServlet 主要 负责 将 HTTP 
的 客户 请 求 信息 组 装 后 ， 根 据 配 置 文件 的 指定 描述 ， 转 发 到 适当 的 处 理 器 。 

按照 Servelt 的 标准 ， 所 有 的 Servlet 必须 在 Web 配置 文件 (web.xml) 声明 。 同 样 ， 
ActoinServlet 必须 在 Web 应 用 的 配置 文件 (web.xml) 中 描述 ， 有 关 配 置信 息 如 下 : 

<Servlet> 

<Servlet-name>action</servlet-name> 

<Servlet-class>org.apache.struts.action.ActionServlet</servlet-class> 

</servlet> 


全 部 的 请 求 URI 以 *.do 的 模式 存在 并 映射 到 这 个 Servlet， 其 配置 如 下 : 

<Servlet-mapping> 

<servlet-name>action</servlet-name> 

<url-pattern>*.do</url-pattern> 

</servlet-mapping> 

一 个 该 模式 的 请 求 URI 符合 如 下 格式 : 

http://www.my_site_name.com/mycontext/actionName.do 

中 心 控 制 器 为 所 有 的 表示 层 请 求 提 供 了 一 个 集中 的 访问 点 。 这 个 控制 器 提供 的 抽象 概 
念 减轻 了 开发 者 建立 公共 应 用 系统 服务 的 困难 ， 如 管理 视图 、 会 话 及 表单 数据 。 它 也 提供 
一 个 通用 机 制 如 错误 及 异常 处 理 、 导 航 、 国 际 化 、 数 据 验证 和 数据 转换 等 。 

当 用 户 向 服务 器 端 提交 请 求 时 , 实际 上 信息 是 首先 发 送 到 控制 器 ActionServlet, 一 旦 控 
制 器 获得 了 请 求 ， 其 就 会 将 请 求 信息 转交 给 一 些 辅助 类 (Help Classes) 处 理 。 这 些 辅助 类 
知道 如 何 去 处 理 与 请 求 信息 所 对 应 的 业务 操作 。 在 Struts 中 ， 这 个 辅助 类 就 是 org.apache. 
struts.action.Action。 通 常 开发 者 需要 自己 继承 Aciton 类 ， 从 而 实现 自己 的 Action 实例 。 


19.3.2 ”使 用 Action 组 件 分离 请 求 和 业务 


ActionServlet 全 部 提交 的 请 求 都 被 控制 器 委托 到 RequestProcessor 对 象 。 
RequestProcessor 使 用 struts-config.xml 文件 检查 请 求 URI 找到 动作 Action 标识 符 。 

一 个 Action 类 的 角色 就 像 客户 请 求 动作 和 业务 轴 辑 处 理 之 间 的 一 个 适配器 (Adaptor) ， 
其 功能 就 是 将 请 求 与 业务 逻辑 分 开 。 这 样 的 分 离 使 得 客户 请 求 和 Action 类 之 间 可 以 有 多 个 
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点 对 点 的 映射 。 而 且 Action 类 通常 还 提供 了 其 他 的 辅助 功能 ， 比 如 : 认证 (Authorization) 、 
志 (Logging) 和 数据 验证 (Validation ) 。 
Action 最 为 常用 的 是 execute() 方 法 。 
public ActionForward execute(ActionMapping mapping,ActionForm form, 
javax.servlet.ServletRequest request, 
javax.servlet.ServletResponse response) 
throws java.io.IOExceptionjavax.servlet.ServletException 
各 注意 : 以 前 的 perform 方法 在 Struts 1.1 中 已 经 不 再 支持 。 
当 Controller 收 到 客户 的 请 求 时 , 在 将 请 求 转移 到 一 个 Action 实例 时 ， 如 果 这 个 实例 不 
存在 ， 控 制 器 会 首先 创建 它 ， 然 后 会 调用 这 个 Action 实例 的 execute() 方 法 。 
Struts 为 应 用 系统 中 的 每 一 个 Action 类 只 创建 一 个 实例 。 因 为 所 有 的 用 户 都 使 用 这 一 个 
实例 ， 所 以 必须 确定 Action 类 运行 在 一 个 多 线程 的 环境 中 。 图 19.8 显示 了 一 个 execute() 方 
法 如 何 被 访问 : 


用 户 ActionServlet 和 | 
请 求 Bs 控制 器 
Eg 
i 模型 
响应 l 
视图 Servlet 容 器 


图 19.8 ”Action 实例 的 execute0 方 法 


外 注意 : 开发 者 继承 的 Action 子 类 ， 必 须 重 写 execute() 方 法 ， 因 为 Action 类 在 默认 情况 下 
是 返回 null 的 。 


19.3.3 ”使 用 ActionMapping 映射 Action 


上 面 讲 到 了 一 个 客户 请 求 是 如 何 被 控制 器 转发 和 处 理 的 ， 但 控制 器 如 何 知 道 什 么 样 的 信息 
转发 到 什么 样 的 Action 类 呢 ? 这 就 需要 一 些 与 动作 和 请 求 信息 相对 应 的 映射 配置 说 明 。 
在 Struts 中 ， 这 些 配置 映射 信息 存储 在 特定 的 XML 文件 (比如 struts-config.xml) 。 这 
些 配 置信 息 在 系统 启动 时 被 读 入 内 存 , 供 Struts 在 运行 期 间 使 用 。 在 内 存 中 , 每 一 个 <action> 
元 素 都 与 org.apache.struts.action.ActionMapping 类 的 一 个 实例 对 应 。 下 面 就 显示 了 一 个 登录 
的 配置 映射 : 
<action-mappings> 
<action path="/logonAction" 
type="com.test.LogonAction" 
name="LogonForm" 
scope="request" 
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input="logoncheck.jsp” 

validate="false"> 

<forward name="welcome'" path="/welcome.jsp"/> 

<forward name="failure" path="/logon failure.jsp "/> 

</action> 

</action-mappings> 

上 面 的 配置 表示 : 当 可 以 通过 /logonAction.do〈 此 处 假设 配置 的 控制 器 映射 为 *.do) 提 
交 请 求 信息 时 ， 控 制 器 将 信息 委托 com.test.LogonAction 处 理 。 调 用 LogonAction 实例 的 
execute() 方 法 。 同 时 将 Mapping 实例 和 所 对 应 的 LogonForm Bean 信息 传 入 。 其 中 name= 
LogonForm， 使 用 form-bean 元 素 所 声明 的 ActionForm Bean。 


19.3.4 ”ActionForm Bean 获取 表单 数据 


在 上 面 讲 解 ActionServlet、ActionClasses 和 ActionMapping 时 ， 都 提 到 了 ActionForm 
Bean 的 概念 。 一 个 应 用 系统 的 消息 转移 〈 或 者 说 状态 转移 ) 的 非 持 久 性 数据 存储 ， 是 由 
ActionForm Bean 负责 保持 的 。 

ActionForm 派生 的 对 象 用 于 保存 请 求 对 象 的 参数 ， 因 此 它们 和 用 户 紧密 联系 。 

-个 ActionForm 类 被 RequestProcessor 建立 。 这 是 发 生 在 已 完成 提交 到 一 个 URL 后 ， 
该 URL 为 映射 到 控制 器 Servlet 而 不 是 JSP 和 相应 的 动作 映射 指定 的 表单 属性 的 。 在 这 种 情 
况 下 ， 如 果 没 有 在 指定 的 活动 范围 内 找到 ，RequestProcessor 将 尝试 寻找 可 能 导致 创建 一 个 
新 ActionForm 对 象 的 表单 Bean。 该 ActionForm 对 象 在 指定 的 活动 范围 内 被 <action> 元 素 的 
name 属性 找到 。 

RequestProcessor 随后 将 重新 安排 表单 属性 ， 用 请 求 时 参数 填充 表单 ， 随 即 调用 表单 对 
象 的 validate(…) 方 法 以 履行 服务 器 端 用 户 输入 验证 。 仅 当 ActionMapping 对 象 中 validate 属 
性 被 设 为 true 时 ，validate(…) 方 法 被 调用 ， 这 就 是 默认 的 行为 。 

request.getParameterValues(parameterName) 被 用 于 得 到 一 个 String[] 对 象 , 它 用 于 表单 填 
充 ; 验证 的 结果 应 该 是 一 个 ActionErrors 对 象 , 用 org.apache.struts.taglib.html.ErrorsTag 来 显 
示 验 证 错误 给 用 户 。ActionForm 也 可 以 被 用 于 为 当前 用 户 保 存 即将 被 一 个 视图 引用 的 中 间 
模型 状态 。 

当 一 个 表单 对 象 被 RequestProcessor 找到 ， 它 被 传递 到 请 求 处 理 器 的 execute(…) 方 法 。 
一 个 ActionForm 对 象 也 可 以 被 请 求 处 理 器 建立 。 表 单 对 象 建立 的 目的 是 提供 中 间 模 型 状态 
给 使 用 请 求 范围 JSP; 这 将 确保 对 象 不 会 在 有 效 性 过 期 后 仍然 存在 。 默 认 情况 下 ， 所 有 表单 
都 被 保存 为 会 话 范围 。 会 话 中 表单 对 象 脱离 有 效 性 的 存在 可 能 导致 浪费 内 存 ， 同 样 地 ， 请 
求 处 理 器 必须 跟踪 保存 在 会 话 中 的 表单 对 象 的 生命 周期 。 一 个 好 的 捕获 表单 数据 的 实践 是 
为 横 跨 多 用 户 交 互 的 相关 表单 用 一 个 单独 的 表单 Bean。 表单 Bean 也 可 以 在 反馈 时 用 来 储存 
能 够 被 自 定 义 标 签 改 变 的 中 间 模 型 状态 。 在 视图 中 标签 用 法 应 避免 结合 Java 代码 ， 因 此 要 
有 一 个 好 的 任务 划分 ，Web 生产 组 主要 处 理 标 志 ， 而 应 用 开发 组 主要 处 理 Java 代码 。 标 签 因 
素 退 出 访问 中 间 模 型 状态 的 逻辑 ， 当 访问 柑 套 的 对 和 象 或 当 通 过 聚集 列举 时 这 个 逻辑 可 能 很 


复杂 。 
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全 注意 : (1) 在 Struts 1.1 中 ，ActionForm 的 校 验 功 能 逐渐 被 剥离 出 来 ( 当然 依然 可 以 使 
用 ) ， 使 用 了 validator 对 整个 应 用 系统 的 表单 数据 验证 进行 统一 管理 。 
(2) 直接 从 ActionFrom 类 继承 的 reset() 和 validate() 方 法 并 不 能 实现 什么 处 理 功 
能 ， 所 以 有 必要 自己 重新 覆盖 。 


19.4 使 用 Struts 开发 用 户 登 录 系 统一 一 Struts 实例 


在 本 节 中 介绍 一 个 用 户 登 录 的 例子 ， 在 这 个 例子 中 ， 实 现 根 据 配 置信 息 确定 用 户 的 合 
法 性 ， 如 果 用 户 的 用 户 名 和 密码 都 是 正确 的 ， 则 让 用 户 登录 系统 ， 而 所 用 用 户 的 信息 是 保 
存在 一 个 资源 文件 中 的 ， 读 者 完全 可 以 改 为 使 用 数据 库 保存 用 户 信 息 。 


19.4.1 开发 模型 组 件 


Struts 的 Model 组 件 包括 ActionForm Bean、 系 统 状 态 Beans 和 商业 逻辑 Beans， 其 中 系 
统 状 态 Beans 和 商业 逻辑 Beans 通常 表示 为 一 组 一 个 或 多 个 的 JavaBeans 类 。 

在 本 实例 中 Model 组 件 由 3 个 类 构成 ， 其 中 一 个 是 LoginForm 类 ， 一 个 是 LoginAction 
类 ， 最 后 一 个 是 LogoutAction 类 ， 下 面 分 别 介绍 这 3 个 类 以 及 它们 的 作用 。 

1. 开发 LoginForm 类 

LoginForm 类 包含 的 属性 和 Login.jsp 视图 中 表单 的 各 个 输入 参数 的 名 称 一 一 对 应 ， 它 
扩展 了 ActionForm 类 。 

在 LoginForm 类 中 定义 了 两 个 属性 : username 和 password， 以 及 它们 对 应 的 setter 和 getter 
方法 ， 这 些 方法 的 定义 是 符合 JavaBeans 的 定义 规则 的 。 下 面 是 LoginForm.java 的 源 代码 : 


package cn.ac.ict; 


import javax.servlet.http.HttpServletRequest'; 
import org.apache. struts.action.ActionError; 
import org.apache. struts.action.ActionErrors; 
import org.apache. struts.action.ActionForm; 
import org.apache.struts.action.ActionMapping; 


public class LoginForm extends ActionForm{ 
// 这 个 Bean 的 属性 

private String password = null; 

private String username = null; 


1/ password 属性 的 获取 和 设置 方法 
public String getPassword() { 
return (this.password); 


public void setPassword(String password) { 
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this.password = password; 


| 


/username 属性 的 获取 和 设置 方法 
public String getUsername(){ 
return (this.username); 
} 
public void setUsername(String username) { 
this.username = username; 


public void reset(ActionMapping mapping,HttpServletRequest request) { 
setPassword(null); 
setUsername(null); 


} 
// 用 于 验证 用 户 输入 是 否 合法 
public ActionErrors validate(ActionMapping mapping, HttpServletRequest request) { 
ActionErrors errors = new ActionErrors(); 
if ((username == null) || (username.length() < 1)) 
errors.add("username",new ActionError("error.username.required")); 
if ((password == null) || (password.length() < 1)) 


errors.add("password",new ActionError("error.password.required")); 
return errors; 


} 


E 

在 LoginForm 类 中 除 定义 了 符合 JavaBeans 规则 的 属性 和 方法 外 ,还 定义 了 一 个 validate 
方法 ， 它 是 用 来 对 客户 提交 的 表单 数据 进行 检查 的 方法 。 

在 本 实例 应 用 中 ， 用 户 名 和 密码 都 是 不 允许 为 空 的 ， 当 任 何 一 个 为 空 ， 都 会 提示 错误 ， 
而 不 同 的 项 缺失 也 会 提示 不 同 的 错误 ,如 果 用 户 名 为 空 , 就 会 抽出 “error.username.required” 
错误 ， 表 示 需 要 填写 用 户 名 。 其 中 “errorusername.required” 只 是 一 个 错误 信息 的 标志 ， 当 
抛 出 这 个 错误 时 ,系统 会 查找 资源 文件 application.properties( 放 在 WEB-INF\classes\resources 
目录 下 ) ， 得 到 需要 输出 的 错误 信息 是 “Username is required”。 同 样 ， 如 果 密 码 没有 填写 
就 会 提示 “Password is required”。 

编译 这 个 文件 需要 把 stmutsjarJAR 文件 加 入 到 类 路 径 中 。 

发 布 这 个 LoginForm 类 时 ， 需 要 在 struts-config.xml 文件 的 <form-beans> 元 素 中 添加 如 
下 子 元 素 ; 

<form-bean name="loginForm'" type="cn.ac.ict.LoginForm" /> 

其 中 name 属性 为 这 个 ActionForm 指定 了 一 个 名 字 ， 供 需要 进行 表单 验证 的 资源 参考 
(refference) 时 使 用 ，type 定义 了 实现 ActionForm 的 具体 类 的 全 名 。 

通过 使 用 <form-beans> 元 素 可 以 为 Web 应 用 定义 多 个 ActionForm，name 是 每 个 
ActionForm 的 惟一 标识 。 
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2. 开发 LoginAction 类 

LoginAction 类 的 作用 是 验证 用 户 的 合法 性 , 并 把 用 户 的 信息 保存 到 Session 中 , 并 根据 
户 登 录 是 否 成 功 返 回 不 同 的 信息 。 

客户 (提交 了 表单 ) 请 求 首先 要 经 过 LoginForm 类 ，LoginForm 类 验证 通过 后 
ActionServlet 把 请 求 转发 给 LoginAction 类 ，LoginAction 类 验证 通过 后 ,把 请 求 转发 给 视图 
组 件 ， 其 中 成 功 和 失败 时 转发 到 不 同 的 视图 组 件 ， 在 struts-config.xml 文件 中 定义 如 下 : 


<action 
path="/LoginSubmit" 
type="cn.ac.ict.LoginAction" 
name="loginForm" 
scope="request" 
validate="true" 
input="/pages/Login.jsp"> 
<forward 
name="success" 
path="/pages/Welcome.jsp"/> 
</action> 


下 面 是 LoginAction 类 的 源 代码 : 


package cn.ac.ict; 


TT 


import java.io.IOException; 

import javax.servlet.ServletException; 

import javax.servlet.http. HttpServletRequest; 
import javax.servlet.http.HttpSession; 

import javax.servlet.http.HttpServletResponse; 
import org.apache.struts.action 


public class LoginAction extends Action { 


// 用 于 验证 用 户 是 否 合法 
public boolean isUserLogin(String username, String password) 
throws UserlnfoException { 


return (Userlnfo.getlnstance().isValidPassword(username,password)); 
// return true; 


) 


public ActionForward execute(ActionMapping mapping, 
ActionForm form, 

HttpServletRequest request, 

HttpServletResponse response) 

throws IOException, ServletException { 

// 获 取 用 户 名 和 密码 

String username = ((LoginForm) form).getUsername(); 
String password = ((LoginForm) form).getPassword(); 
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boolean validated = false; 
try{ 
validated = isUserLogin(username,password); 


}catch (UserlnfoException uie) { 
// 抛 出 错误 信息 
ActionErrors errors = new ActionErrors(); 
errors.add(ActionErrors.GLOBAL_ERROR,new ActionError("error.login.connect")); 
saveErrors(request,errors); 
// 返回 输入 页 面 
return (new ActionForward(mapping.getlnput())); 


} 


if (Ivalidated) { 
// 验 证 不 通过 时 
ActionErrors errors = new ActionErrors(); 
errors.add(ActionErrors.GLOBAL_ERROR,new ActionError("error.login.invalid")); 
saveErrors(request,errors); 
// 返回 输入 页 面 
return (new ActionForward(mapping.getIinput())); 


} 


HttpSession session = request.getSession(); 
Session.setAttribute(Constants.USER_KEY, form); 


return (mapping.findForward(Constants.SUCCESS)); 


} 

} 

在 这 个 类 中 定义 了 两 个 方法 : isUserLogin 和 execute。 

口 isUserLogin 方法 用 于 验证 某 个 用 户 的 信息 是 否 合法 ,用 户 信息 的 处 理 是 通过 辅助 类 
UserInfo 来 实现 的 ， 它 读 取 用 户 信 息 资 源 文件 ， 并 对 用 户 的 合法 性 进行 验证 。 

口 execute 方法 是 这 个 类 的 主要 方法 ， 它 调用 isUserLogin 方法 对 客户 身份 进行 验证 ， 
如 果 验 证 通过 ， 会 把 客户 的 信息 保存 到 Session 中 ， 并 把 请 求 转发 到 
Constants.SUCCESS 指定 的 视图 页 面 : 


HttpSession session = request.getSession(); 
Session.setAttribute(Constants.USER_KEY, form); 


return (mapping.findForward(Constants.SUCCESS)); 
而 如 果 验 证 失败 ， 就 会 构造 一 个 ActionErrors 对 象 ， 并 把 客户 请 求 转 发 到 输入 页 面 : 


ActionErrors errors = new ActionErrors(); 
errors.add(ActionErrors.GLOBAL_ERROR,new ActionError("error.login.invalid")); 
saveErrors(request,errors); 

// 返回 输入 页 面 

return (new ActionForward(mapping.getlnput())); 
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编译 这 个 文件 需要 把 Struts.jarJAR 文件 加 入 到 类 路 径 中 。 另 外 发 布 这 个 LoginAction 类 
时 ， 需 要 在 struts-config.xml 文件 的 <action-mappings> 元 素 中 添加 如 下 子 元 素 ( 元 素 属性 的 
意义 参考 19.2.3 节 ) : 


<action 
path="/LoginSubmit" 
type="cn.ac.ict.LoginAction" 
name="loginForm" 
scope="request" 
validate="true" 
input="/pages/Login.jsp"> 
<forward 
name="success" 
path="/pages/Welcome.jsp"/> 
</action> 


可 以 看 到 如 果 用 户 身份 验证 通过 ， 请 求 将 被 转发 到 /pages/Welcome.jsp。 

3. LogoutAction 类 

LogoutAction 类 的 作用 和 LoginAction 类 是 相对 的 ， 它 完成 的 工作 是 将 保存 在 Session 
中 的 用 户 删 除 ,表示 客户 退出 了 登录 , 并 把 请 求 转 发 到 合适 的 视图 组 件 , 下 面 是 LogoutAction 
类 的 源 代码 : 


package cn.ac.ict; 


import java.io.IOException; 

import java.util.Hashtable; 

import java.util.Locale; 

import java.util.Vector; 

import javax.servlet.RequestDispatcher' 
import javax.servlet.ServletException; 

import javax.servlet.http.HttpServletRequest'; 
import javax.servlet.http.HttpSession; 

import javax.servlet.http.HttpServletResponse; 
import org.apache.struts.action 

import org.apache.struts.util.MessageResources; 


public class LogoutAction extends Action { 


public ActionForward execute(ActionMapping mapping,ActionForm form,HttpServletRequest 
request， 
HttpServletResponse response)throws IOException, ServletException { 


HttpSession session = request.getSession(); 
LoginForm user = (LoginForm)session.getAttribute(Constants.USER_KEY); 


session.removeAttribute(Constants.USER_KEY); 
// 将 页 面 转发 到 成 功 页 面 
return (mapping.findForward(Constants.SUCCESS)); 
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编译 这 个 文件 需要 把 strutsjar 这 个 JAR 文件 加 入 到 类 路 径 中 。 
发 布 这 个 LogoutAction 类 时 ， 需 要 在 struts-config.xml 文件 的 <action-mappings> 元 素 中 
添加 如 下 子 元 素 〈 元 素 属性 的 意义 参考 19.2.2 节 ) 。 
<action 
path="/Logout" 
type="cn.ac.ict.LogoutAction"> 
<forward 
name="success" 
path="/pages/Welcome.jsp"/> 
</action> 


19.4.2 ”开发 视图 组 件 


Struts 的 View 组 件 包括 一 组 JSP 页 面 ， 这 些 JSP 文件 中 可 以 包含 Struts 标签 (有 的 元 
素 可 以 不 使 用 Struts 标签 表示 ， 不 过 有 的 就 必须 使 用 Struts 标签 ， 而 且 Struts 标签 比较 多 ， 
对 于 初学 者 来 说 有 点 难度 )。 在 本 实例 中 有 3 个 JSP 页 面 : Login.jsp、Welcome.jsp 和 index.jsp。 
1. 编写 index.jsp 
index.jsp 页 面 是 很 简单 的 ， 它 就 是 作为 这 个 Web 应 用 的 默认 页 面 。 它 什么 都 不 显示 ， 
只 是 把 请 求 转 发 给 其 他 的 页 面 ， 下 面 是 index.jsp 的 源 代码 : 
<%@ taglib uri="/tags/struts-logic" prefix="|logic" %> 
<logic:forward name="welcome"/> 
<logic:forward> 标 签 用 于 转发 请 求 。 在 这 个 页 面 中 ， 使 用 了 Struts 标签 ， 把 请 求 转发 给 
了 welcome。 在 struts-config.xml 文件 中 定义 了 如 下 的 全 局 转发 : 
<forward 
name="welcome" 
path="/Welcome.do"/> 
在 <action-mappings> 元 素 中 定义 了 如 下 元 素 : 


<action 
path="/Welcome" 
type="org.apache.struts.actions.ForwardAction" 
parameter="/pages/Welcome.jsp"/> 


也 就 是 说 ,根据 struts-config.xml 文件 的 定义 ， 请 求 将 最 终 被 转发 到 Welcome.jsp 页 面 。 

2. 编写 Welcome.jsp 

Welcome.jsp 是 Web 应 用 的 欢迎 页 面 , 其 中 提供 了 用 于 登录 的 链接 , 下面 是 Welcome.jsp 
的 源 代码 : 

<%@ taglib uri="/tags/struts-bean" prefix="bean" %> 

<%@ taglib uri="/tags/struts-html" prefix="html" %> 

<%@ taglib uri="/tags/struts-logic" prefix="|logic" %> 


<html:html locale="true"> 
<HEAD> 
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<TITLE><bean:message key="Wwelcome .title"/></TITLE> 
<html:base/> 
</HEAD> 
<BODY> 
<logic:present name="user"> 
<H3>Welcome <bean:write name="user property="username"/>!</H3> 
</logic:present> 


<logic:notPresent scope="session" name="User"> 
<H3><bean:message key="app.hello"/></H3> 
</logic:notPresent> 


<html:errors/> 
<UL> 


<LI><html:link forward="login">Log in</html:link></LI> 


<logic:present name="user"> 
<LI><html:link forward="logout">Log out</html:link></LI> 
</logic:present> 
</UL> 
</BODY> 
</html:html> 


可 以 看 到 这 个 文件 中 使 用 了 大 量 的 Struts 标签 , 文件 最 开始 就 引入 了 3 个 标签 文件 ,这 
些 Bean 文件 中 定义 了 大 量 的 标签 ，Struts 标签 库 的 描述 如 表 19.7 所 示 。 


表 19.7 Struts 标 签 库 的 描述 


属 性 描述 

Struts-bean 标签 库 中 的 JSP 自 定义 标签 的 主要 作用 是 用 于 访问 Bean 的 属性 ， 以 及 基于 这 
些 访问 而 定义 新 的 Bean， 使 得 页 面 可 以 通过 脚本 变量 和 页 面 内 的 属性 来 访问 这 些 Bean 

证 Struts 的 HTML 标 签 库 包含 用 于 生成 Struts 的 用 户 界 面 的 标签 ， 该 标签 功能 和 HTML 中 的 

85 | FORM 相 似 ， 不 同 的 是 该 标签 将 用 户 输入 参数 推 入 设 定 的 ActionForm Bean 当 中 

Logi fog Struts 的 logic 标 签 库 包含 用 于 控制 输出 文本 条 件 、 对 集合 对 象 迁 代 以 及 应 用 流程 控制 方 
面 的 标签 ,该 标签 中 的 大 部 分 标签 功能 在 JSTL 的 core 标 签 库 中 有 相同 或 类 似 功能 的 标签 

Struts 的 nested 标 签 库 包含 的 标签 库 是 扩展 其 他 标签 库 的 标签 ， 该 标签 库 使 得 Struts 框 架 


中 的 标签 能 够 知道 包含 它 的 标签 ， 以 正确 地 设置 其 中 的 内 顽 属 性 
该 库 包 含 的 标签 可 用 作 页 面 创建 动态 的 JSP 模 板 ， 这 些 页 面 都 拥有 一 个 公共 的 外 观 或 者 
共同 的 格式 
Tiles 框 架 提供 一 种 模板 机 制 ， 它 能 将 布局 和 内 容 的 职责 分 离 
在 这 个 文件 的 第 4 行使 用 了 一 个 <html:html> 标 签 , 它 来 自 于 struts-html 标签 库 ， 作 用 与 
HTML 语言 中 的 <html> 元 素 一 样 ， 在 Struts 中 不 是 必需 的 ， 完 全 可 以 使 用 HTML 语言 中 的 
<html> 元 素 代 蔡 。 
在 这 个 文件 的 第 6 行使 用 了 一 个 <bean:message key="welcome:title"/> 标 签 ， 它 来 自 于 
struts-bean 标签 库 ， 作 用 是 从 Web 应 用 的 资源 配置 文件 application.properties 中 读 取 key 指 
定 的 内 容 ， 例 如 在 application.properties 文件 中 包含 如 下 内 容 : 


Template Tags 


Tiles Tags 
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welcome.title=Struts Login Example Application 
则 这 个 页 面 显 示 时 ， 浏 览 器 的 标题 栏 将 显示 Struts 


Login Example Application， 如 图 19.9 所 示 。 
人 行 ~ .17 行 了 一 个 i EE Ee | | 
在 这 个 文件 的 第 10 行 一 12 行使 用 了 一 个 <logic: La em | 

presen 人 > 标签 ， 它 来 自 于 struts-logic 标签 库 ， 作 用 是 检 阿 兽 一 广 一 广 广 三 风 Re 一 = 


查 request 对 象 (由 scope 指定 , 如 果 不 指定 表示 request 。 图 19.9 <bean:message> 元 素 的 作用 
范围 ) 中 参数 (name 属性 指定 ) 是 否 存 在 ， 如 果 存 在 
就 执行 这 个 元 素 之 间 的 内 容 ， 也 就 是 下 面 的 内 容 : 

<H3>Welcome <bean:write name="user" property="username'"/>!</H3> 

<logic:notPresent> 标 签 的 作用 是 和 <logic:present> 标 签 相 反 的 ， 如 果 它 所 指定 的 属性 不 
存在 时 ， 执 行 元 素 之 间 的 内 容 : 

<H3><bean:message key="app.hello"/></H3> 

其 中 使 用 了 <bean:message> 标 签 ， 执 行 结 果 显 示 如 下 : 

Welcome Guest Come Herel 

3. 编写 Login.jsp 

Login.jsp 用 于 提供 FORM 表单 , 在 这 个 页 面 中 可 以 输入 用 户 名 和 密码 ,其 源 代码 如 下 : 


<%@ taglib uri="/tags/struts-bean" prefix="bean" %> 
<%@ taglib uri="/tags/struts-html" prefix="html" %> 
<HTML> 
<HEAD> 
<TITLE><bean:message key="welcome.title"/></TITLE> 
</HEAD> 
<BODY> 
<html:errors/> 
<html:form action="/LoginSubmit" focus="username"> 
<TABLE border="0" width="100%"> 
<TR> 
<TH align="right"><bean:message key="app.username"/>:</TH> 
<TD align="left"><html:text property="username"/></TD> 
</TR> 
<TR> 
<TH align="right"><bean:message key="app.password"/>:</TH> 
<TD align="left"><html:password property="password"/></TD> 
</TR> 
<TR> 
<TD align="right"><html:submit/></TD> 
<TD align="left"><html:reset/></TD> 
</TR> 
</TABLE> 
</html:form> 
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</BODY> 
</HTML> 


其 中 <html:text>、<html:password>、<html:submit/> 和 <html:reset/> 分 别 相 当 于 HTML 语 
言 中 的 <input type="text"> 、<input type="password"> 、<input type="submit"> 和 <input 
type="reset">。 

<html:form> 元 素 用 于 定义 表单 ， 和 HTML 语言 中 的 <form> 作 用 相同 。 它 的 Action 为 
LoginSubmit， 在 struts-config.xml 文件 中 将 LoginSubmit 定义 为 : 


<action 
path="/LoginSubmit" 
type="cn.ac.ict.LoginAction" 
name="loginForm" 
scope="request" 
validate="true" 
input="/pages/Login.jsp"> 
<forward 
name="success" 
path="/pages/Welcome.jsp"/> 
</action> 


19.4.3 ”开发 辅助 类 


通过 创建 Struts 的 Model 组 件 和 View 组 件 ， 可 以 发 现在 这 个 应 用 中 使 用 了 辅助 类 ， 包 
括 : UserInfo.java、Constants.java 和 UserInfoException.java。 

1. UserInfo.java 

UserInfojava 用 于 维护 用 户 信息 、 获 取 用 户 名 和 密码 、 验 证 用 户 名 和 密码 的 正确 性 以 及 
添加 合法 用 户 等 ， 其 源 代 码 如 下 : 


package cn.ac.ict; 


import java.io.IOException; 
import java.io.InputStream; 
import java.io.FileOutputStream; 
import java.util.Enumeration; 
import java.util.Properties; 


public class Userlnfof 
/存放 用 户 信息 的 文件 
private static final String UserlnfoFile = 
"resources/users.properties"; 
// 用 户 信息 存放 的 格式 
private static final String UserlnfoHeader = 
"${user}=${password}"; 


private static Userlnfo Userlnfo = null; 
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private static Properties p; 

/构造 函数 被 设置 为 private， 类 外 无 法 实例 化 这 个 类 
private Userlnfo() throws UserlnfoException { 
InputStream i = null; 


p = null; 
i=this.getClass().getClassLoader().getResourceAsStream(UserlnfoFile); 
if (i==null) { 
throw new UserlnfoException(); 
jelse{ 
ty{ 
p= new Properties(); 
p.load(i); 
iclose(); 
j 
catch (IOException e){ 
p= null; 
System.out.printin(e.getMessage!()); 
throw new UserlnfoException(); 
b 
finally { 
i= null; 
b 
}//end else 


}//end Userlnfo 
// 获 取 一 个 Userlnfo 的 实例 
public static Userlnfo getlnstance() throws UserlnfoException { 
if(null==Userlnfo) { 
Userlnfo = new Userlnfo(); 


} 


return Userlnfo; 


} 


public String fixld(String userld) { 
return userld.toUpperCase(); 


} 
// 判 断 是 否 为 合法 用 户 
public boolean isValidPassword(String userld, String password) { 


if (password==null) return false; 


/ 把 用 户 名 转化 为 大 写字 母 
String _userld = fixld(userld); 


/ 用 户 不 存在 


if (lisUserExist(_userld)) return false; 


/ 用 户 存 在 并 且 密 码 正确 
return (password.equals(getPassword(_userld))); 


} 
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public boolean isUserExist(String userld){ 


// 用 户 名 为 空 时 返回 不 存在 

if (userld==null) return false; 

// 用 户 不 存在 

return !(p.getProperty(userld)==null); 


} 

// 获 得 某 个 合法 用 户 的 密码 

public String getPassword(String userld) { 
return p.getProperty(userld); 

} 

// 取 得 所 有 合法 的 用 户 名 

public Enumeration getUserlds() { 

return p.propertyNames(); 
b 


public void setUser(String userld, String password) throws 
UserlnfoException { 
if ((userld==null) || (password==nuIl)) { 
throw new UserlnfoException(); 
b 
try{ 
/ 添加 新 的 合法 用 户 并 存储 
p.put(fixld(userld), password); 
p.store(new FileOutputStream(UserlnfoFile)， 
UserlnfoHeader); 
}catch (IOException e){ 
throw new UserlnfoException(); 


} 
在 这 个 类 的 构造 函数 中 ， 读 取 了 用 户 信息 文件 ， 并 把 用 户 的 信息 保存 到 properties 对 象 
中 ， 用 于 后 面 对 用 户 的 身份 进行 验证 : 


private Userlnfo() throws UserlnfoException { 
InputStream i = null; 
p = null; 
i= this.getClass().getClassLoader().getResourceAsStream(UserlnfoFile); 
if (null==i) { 
throw new UserlnfoException(); 
jelse{ 
try{ 
p= new Properties(); 
poad(i); 
iclose(); 
catch (IOException e){ 
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p= null; 
System.out.printin(e.getMessage!()); 
throw new UserlnfoException(); 

} 

finally { 
i= null; 

b 


}//end else 


} 


而 且 这 个 类 的 构造 函数 被 定义 为 private， 也 就 是 说 外 部 类 是 不 可 以 实例 化 


因此 这 个 类 提供 了 一 个 获取 UserInfo 对 象 的 方法 getInstance()， 代 码 如 下 : 


public static Userlnfo getlnstance() throws UserlnfoException { 
if (null==Userlnfo){ 
Userlnfo = new Userlnfo(); 


} 


return Userlnfo; 


} 
2. 编写 Constants.java 


Constants.java 定义 了 一 些 静 态 常量 ， 供 在 其 他 地 方 引用 ， 其 源 代码 如 下 : 


package cn.ac.ict; 


public class Constants { 


pr 
* 应 用 程序 的 包 名 
a 

public static final String Package = "app"; 


pe 
* 存储 在 Session 中 的 属性 名 称 
y 

public static final String USER_KEY = "user"; 


/= 
*ActionForward 中 的 一 个 
3 

public static final String SUCCESS = "success"; 


/ie 
* ActionForward 中 的 一 个 
2 

public static final String LOGIN = "login"; 


pe 
* ActionForward 中 的 一 个 
| 


“3359 


这 个 类 的 ， 
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public static final String WELCOME = "welcome"; 


} 

3. UserInfoException.java 

UserInfoException.java 定义 了 一 个 异常 ， 这 个 异常 只 继承 了 Exception 类 ， 不 做 任何 事 
情 ， 其 代码 如 下 : 

package cn.ac.ict; 


public class UserlnfoException extends Exception { 
// 没有 实现 


} 
19.4.4 创建 配置 文件 


在 编写 好 相关 的 类 后 ,就 可 以 编写 Struts 的 配置 文件 了 , 下 面 是 这 个 应 用 的 struts-config. 
xml 文件 的 完整 代码 : 


<?xml version="1.0" encoding="ISO-8859-1" ?> 


<!DOCTYPE struts-config PUBLIC 
"-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" 
"http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd"> 


<struts-config> 


<!-- 配置 使 用 的 FormBean --> 
<form-beans> 
<form-bean name="loginForm'" type="cn.ac.ict.LoginForm" /> 
</form-beans> 


<global-exceptions> 
</global-exceptions> 
<!-- ”定义 全 局 转发 --> 
<global-forwards> 
<forward 
name="welcome" 
path="/Welcome.do"/> 
<forward 
name="logout" 
path="/Logout.do"/> 
<forward 
name="login" 
path="/Login.do"/> 


</global-forwards> 
<!-- ============= 定义 ActionMapping============ --> 
<action-mappings> 
<!-- Default "Welcome" action —> 
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<!-- Forwards to Welcome.jsp --> 

<action 
path="/Welcome" 
type="org.apache.struts.actions.ForwardAction" 
parameter="/pages/Welcome.jsp"/> 


<action 
path="/Login" 
type="org.apache.struts.actions.ForwardAction" 
parameter="/pages/Login.jsp"/> 


<action 
path="/LoginSubmit" 
type="cn.ac.ict.LoginAction" 
name="loginForm" 
scope="request” 
validate="true”" 
input="/pages/Login.jsp"> 
<forward 
name="success" 
path="/pages/Welcome.jsp"/> 
</action> 


<action 
path="/Logout" 
type="cn.ac.ict.LogoutAction"> 
<forward 
name="success" 
path="/pages/Welcome.jsp"/> 
</action> 
</action-mappings> 
<!-- ”配置 使 用 的 Message 资源 --> 
<message-resources parameter="resources.application"/> 
</struts-config> 


这 个 文件 中 各 个 元 素 的 作用 在 19.2.2 节 中 已 介绍 过 ， 这 里 就 不 详细 介绍 了 ， 值 得 注意 
的 是 这 个 文件 的 最 后 一 个 元 素 : 
<message-resources parameter="resources.application /> 


它 指 明了 应 用 程序 使 用 的 消息 资源 文件 ， 这 个 文件 应 该 放 在 Web 应 用 的 WEB-INF\classes\ 
resources 目录 下 ， 其 中 保存 了 应 用 中 使 用 的 消息 。 


19.4.5 发布 Web 应 用 


在 上 一 节 中 一 步 步 创 建 了 一 个 基于 Struts 的 Web 应 用 ， 下 面 介绍 如 何 运 行 这 个 应 用 ， 
读者 可 以 按照 如 下 步骤 发 布 这 个 应 用 : 
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(1) 编译 所 有 的 Java 文件 ， 这 个 过 程 需 要 把 Struts 的 支持 JAR 文件 放 到 类 路 径 中 ， 
把 编译 后 的 字 节 码 文件 复制 到 Web 应 用 的 WEB-INF\classes 目录 下 ， 存 放 的 目录 层次 和 包 
的 层次 是 一 致 的 ， 此 时 Web 应 用 的 目录 结构 如 图 19.10 所 示 。 

(2) 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/StrutsLogin/， 
可 以 看 到 页 面 如 图 19.11 所 示 。 
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图 19.10 Web 应 用 的 目录 结构 图 19.11 Struts Login 应 用 


在 地 址 栏 中 http://localhost:8080/StrutsLogin/ 由 于 没有 指定 特点 的 资源 ，Tomcat 使 用 
Struts Login 应 用 的 默认 页 面 index.jsp 响应 客户 。 

在 页 面 index.jsp 中 不 做 任何 显示 工作 ， 只 是 把 请 求 转发 到 welcome 资源 ， 根 据 struts- 
config.xml 文件 的 定义 welcome 是 全 局 转发 , 它 对 应 了 Welcome.do 这 个 Action, 而 在 struts- 
config.xml 文件 中 有 如 下 定义 : 

<action 
path="/Welcome" 
type="org.apache.struts.actions.ForwardAction" 
parameter="/pages/Welcome.jsp"/> 

也 就 是 说 ，index.jsp 页 面 最 后 把 请 求 转发 到 了 Welcome.jsp， 单 击 这 个 页 面 中 的 Log in 
链接 后 ， 链 接 到 Login.do 资源 ， 根 据 struts-config.xml 文件 的 如 下 定义 : 

<action 
path="/Login" 
type="org.apache.struts.actions.ForwardAction" 
parameter="/pages/Login.jsp"/> 


Welcome Guest Come Here! 


[| 
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请 求 被 转发 到 Login.jsp 页 面 ， 所 以 页 面 显示 如 图 19.12 。 EEee 


PE SE 
3 ET EC 全 
所 示 。 OO- dm vr DB " 
名 加 | 闻 ， /eetn000/s totocinene se。 可 加 和 
一 | 

19.4.6 ”Web 应 用 分 析 RE 

si | esat | 
1. 表单 验证 [BE [ad ed a rt 


A Be i 图 19.12 Loginjsp 页 面 
用 户 可 以 在 如 图 19.12 所 示 的 页 面 中 输入 信息 并 提交 
登录 系统 。 客 户 在 提交 了 请 求 后 ， 服 务 器 的 执行 流程 如 下 : 
(1) Tomcat 从 Web 应 用 的 web.xml 文件 中 对 用 户 请 求 的 URL 进行 匹配 ， 发 现 了 如 
下 定义 : 
<servlet-mapping> 
<servlet-name>action</servlet-name> 
<url-pattern>*.do</url-pattern> 
</servlet-mapping> 


也 就 是 说 所 有 以 .do 结尾 的 URL 请 求 都 会 被 命名 为 Action 的 Servlet 进行 处 理 。 
(2) Tomcat 根据 <servlet-name> 找 到 了 对 Action 的 定义 ， 它 是 Struts 的 ActionServlet 
类 ， 也 就 是 控制 器 类 : 
<Servlet> 
<servlet-name>action</servlet-name> 
<Servlet-class>org.apache.struts.action.ActionServlet</servlet-class> 
<init-param> 
<param-name>config</param-name> 
<param-value>/WEB-INF/struts-config.xml</param-value> 
</init-param> 
<init-param> 
<param-name>debug</param-name> 
<param-value>2</param-value> 
</init-param> 
<init-param> 
<param-name>detail</param-name> 
<param-value>2</param-value> 
</init-param> 
<load-on-startup>2</load-on-startup> 
</servlet> 


(3) ActionServlet 检查 这 个 表单 是 否 需要 进行 验证 ， 它 在 struts-config.xml 文件 中 发 现 
路 径 为 /LoginSubmit 的 Action 指定 了 使 用 名 为 loginForm 的 ActionForm 进行 验证 ， 而 
loginForm 在 struts-config.xml 文件 中 是 这 样 定义 的 : 
<form-beans> 


<form-bean name="|loginForm" type="cn.ac.ict.LoginForm" /> 
</form-beans> 


也 就 是 说 , 当 提 交 路 径 为 LoginSubmit.do 时 , 需要 使 用 cn.ac.ict.LoginForm 类 进行 验证 ， 
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这 是 控制 器 创建 一 个 cn.ac.ict.LoginForm 类 的 对 象 。 

(4) 控制 器 调用 cn.ac.ict.LoginForm 的 validate 方法 ， 检 查 用 户 名 和 密码 是 否 为 空 ， 
如 果 有 任何 一 个 为 空 会 返回 一 个 ActionErrors 的 对 象 , 然后 控制 器 根据 <action> 元 素 的 input 
属性 把 客户 的 请 求 转发 给 Login.jsp， 并 显示 错误 信息 。 当 只 有 用 户 名 为 空 时 弹出 的 错误 消 
息 ， 如 图 19.13 所 示 。 当 用 户 名 和 密码 都 为 空 时 弹出 的 错误 消息 ， 如 图 19.14 所 示 。 
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(5) 如 果 用 户 名 和 密码 都 不 为 空 时 ， 表 单 验 证 通过 ， 控 制 器 把 请 求 转发 给 客户 请 求 的 
2. 用 户 登 录 验 证 
如 果 用 户 的 表单 验证 失败 ， 控 制 器 就 根据 配置 文件 转发 请 求 并 显示 错误 ， 如 果 通 过 了 
控制 器 把 请 求 转 发 给 客户 请 求 的 资源 ， 进 行 如 下 的 流程 

(1) 在 上 面 的 例子 中 ， 如 果 客 户 的 表单 验证 通过 了 ， 控 制 器 会 把 请 求 转发 给 
LoginSubmit.do 。 

(2) Tomcat 根据 web.xml 文件 中 的 定义 ， 把 这 个 请 求 交 给 ActionServlet 处 理 ， 
ActionServlet 根据 struts-config.xml 文件 中 的 定义 ， 把 客户 请 求 交 给 cn.ac.ict.LoginAction 类 
处 理 。 

(3) ActionServlet 创建 一 个 LoginAction 实例 ， 然 后 调用 这 个 对 象 的 execute 方法 。 

(4) 在 execute 方法 调用 了 isUserLogin 方法 验证 用 户 的 名 称 和 密码 是 否 被 允许 登录 后 ， 
实际 的 操作 过 程 在 UserInfo 类 中 完成 ， 具 体 实现 过 程 可 以 参考 19.3.4 节 中 的 定义 。 

(5) 如 果 用 户 身份 得 到 确认 ， 也 就 被 允许 登录 了 ，LoginAction 对 象 将 把 用 户 的 信息 存 
到 Session 的 一 个 对 象 中 ， 并 返回 成 功 标志 。 

(6) ActionServlet 从 action 的 属性 中 查找 验证 成 功 时 需要 转发 的 页 面 ， 看 到 action 的 
如 下 定义 : 

<action 
path="/LoginSubmit" 
type="cn.ac.ict.LoginAction" 
name="loginForm" 
scope="request" 
validate="true”" 
input="/pages/Login.jsp"> 
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<forward 
name="success" 
path="/pages/Welcome.jsp"/> 
</action> 
也 就 是 成 功 时 把 请 求 转发 到 Welcome.jsp 页 面 ， 此 时 的 Welcome.jsp 显示 如 图 19.15 
所 示 。 
(7) 如 果 用 户 不 被 允许 登录 (没有 合法 用 户 名 或 密码 错误 ) ，LoginAction 对 象 生成 一 
个 错误 对 象 ， 并 把 它 保存 到 request 对 象 中 ， 然 后 把 请 求 转发 ， 目 标 是 action 元 素 的 input 
属性 指定 的 页 面 ， 也 就 是 Login.jsp， 此 时 显示 页 面 如 图 19.16 所 示 。 
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在 图 19.15 的 页 面 中 单 击 Log out 链接 ， 处 理 的 流程 与 上 面 差 不 多 ， 只 是 把 请 求 交 给 
cn.ac.ict.LogoutAction 处 理 ， 在 这 个 类 中 ， 把 客户 信息 从 Session 中 清除 ， 并 把 请 求 转发 给 
Welcome.jsp。 此 时 页 面 显示 如 图 19.11 所 示 。 


19.5 小 结 


在 第 18 章 中 介绍 了 一 点 模型 一 视图 一 控制 器 (MVC) 的 相关 知识 ， 在 这 一 章 中 介绍 了 
一 个 经 典 的 MVC 模式 的 实现 一 Struts。 

Struts 的 控制 器 由 ActionServlet 和 Action 来 担任 ，Model 模型 主要 由 ActionForm 和 系统 
状态 Beans 和 商业 逻辑 Beans 构成 ， 而 视图 部 分 大 部 分 为 JSP 页 面 ， 也 可 以 是 HTML 页 面 。 

读者 学 习 的 重点 应 该 在 了 解 各 个 组 件 作 用 以 及 如 何 使 用 它们 ， 多 实践 一 些 例子 是 很 有 
必要 的 ， 读 者 在 搞 懂 Struts 后 ， 也 可 以 参考 后 面 几 童 的 介绍 ， 看 看 几 种 MVC 模式 实现 的 共 
同 之 处 。 
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在 19 章 中 介绍 了 Struts， 在 本 章 将 介绍 一 种 MVC 的 实现 一 一 WebWork2。WebWork 
是 由 OpenSymphony 组 织 开发 的 ， 致 力 于 组 件 化 和 代码 重用 的 拉 出 式 MVC 模式 J2EE Web 
框架 。 但 现在 WebWork 已 经 被 拆 分 成 了 XWorkl 和 WebWork2 两 个 项 目 ， 本 书 只 是 介绍 
WebWork2。 


20.1 快速 体验 WebWork2 简单 应 用 实例 


20.1.1 WebWork2 简介 


WebWork 是 由 OpenSymphony 组 织 开 发 的 ， 致 力 于 组 件 化 和 代码 重用 的 拉 出 式 MVC 
模式 J2EE Web 框架 。 

WebWork 目前 最 新 版 本 是 2.1， 现 在 的 WebWork2.x 前 身 是 Rickard Oberg 开发 的 
WebWork， 但 现在 WebWork 已 经 被 拆 分 成 了 XWorkl 和 WebWork2 两 个 项 目 ， 如 图 20.1 


所 示 。 
WebWork2 上 Web 


上 上 | Web 


图 20.1 WebWork 被 拆 分 成 了 Xworkl 和 WebWork2 两 个 项 目 


XWork 简洁 、 灵 活 功能 强大 ， 它 是 一 个 标准 的 Command 模式 实现 ， 并 且 完 全 从 Web 
层 脱 离 出 来 。XWork 提供 了 很 多 核心 功能 : 前 端 拦截 机 (interceptor) 、 运 行 时 表单 属性 验 
证 、 类 型 转换 、 强 大 的 表达 式 语言 (the Object Graph Notation Language，OGNL ) 和 IoC 
(Inversion of Control 倒置 控制 ) 容器 等 。 
WebWork2 建立 在 XWork 之 上 ， 用 于 处 理 HTTP 的 响应 和 请 求 。WebWork2 使 用 
ServletDispatcher 将 HTTP 请 求 变 成 Action (业务 层 Action 类 ) 、Session (会 话 )、Application 
(应 用 程序 ) 范围 的 映射 和 request 请 求 参数 映射 。WebWork2 支持 多 视图 表示 ， 视 图 部 分 
可 以 使 用 JSP、Velocity、FreeMarker、JasperReports 和 XML 等 。 在 WebWork2 中 添加 了 对 


WebWork 


第 20 章 MVC 模式 实现 一 WebWork2 。367 。 
AJAX 的 支持 ， 这 些 支持 构建 在 DWR 与 Dojo 这 两 个 框架 的 基础 之 上 。 
20.1.2 ”建立 WebWork2 开发 环境 


WebWork2 可 以 从 其 官方 网 站 http://www.opensymphony.com/webwork/ 免 费 下 载 。 可 按 
照 如 下 步骤 建立 WebWork2 环境 。 

(1) 将 下 载 后 的 webwork-2.1.7.zip 文件 解压 缩 到 本 地 硬盘 ， 设 定 其 解压 目录 为 
<Webwork2 HOME>。 

(2) 把 <Webwork2_HOME> 目 录 下 的 webwork-2.1.7.jar 文件 和 <Webwork2_HOME> 
\lib\core 目录 下 的 JAR 文件 复制 到 Web 应 用 的 WEB-INFNlib 目录 下 。 

(3) 这 样 后 就 可 以 Web 应 用 使 用 WebWork2 了 。 下 面 演示 发 布 一 个 WebWork2 自 带 的 
例子 。 
把 <Webwork2 HOME>\webwork-example.war 文件 复制 到 <TOMAT_HOME>\webapps 
目录 下 ,启动 Tomcat, 在 浏览 器 地 址 栏 中 输入 地 址 : http://localhost:8080/webwork-example/， 
可 以 看 到 页 面 显 示 如 图 20.2 所 示 。 
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图 20.2 WebWork-Example 欢迎 页 面 
20.1.3 ”实例 介绍 


在 本 节 要 介绍 的 例子 是 一 个 用 户 登 录 的 例子 ， 在 这 个 例子 中 ， 用 户 在 登录 页 面 中 输入 
用 户 名 和 密码 ， 提 交 后 由 服务 器 端的 程序 验证 用 户 名 和 密码 是 否 正确 ， 如 果 正 确 就 转向 欢 
迎 界面 ， 否 则 在 登录 界面 显示 错误 信息 ， 在 这 个 简单 的 例子 中 ， 贯 穿 了 WebWork 框架 的 大 
部 分 应 用 技术 ， 读 者 可 以 对 WebWork2 有 个 大 致 的 认识 。 


20.1.4 开发 构成 类 和 JSP 文件 


1. 视图 一 一 JSP 页 面 
首先 来 看 本 实例 需要 使 用 的 登录 信息 输入 页 面 indexjsp。 在 这 个 页 面 中 用 于 接受 用 户 
的 输入 ， 如果 用 户 的 用 户 名 和 密码 正确 , 将 会 转发 到 main.jsp 视图 ,否则 在 登录 页 面 显示 错 
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误 信 息 ， 其 完整 代码 如 下 : 


<%@ page pageEncoding="gb2312" contentType="text/html;charset=gb2312"%> 


<%@ taglib prefix="ww" uri="webwork"%> 


<html> 
<body> 
<form action="login.action"> 
<p align="center"> 登 录 <br> 
<ww:if test="loginlnfo.errorMessage != null"> 
<font color="red"> 
<ww:property value="loginlnfo.errorMessage'"/> 
</font> 
</ww:if> 
</p> 
用 户 名 : 
<input type="text" name="loginlnfo.username'" /> 
<br> 
密码 : 
<input type="password" name="loginlnfo.password" /> 
<br> 
<p align="center"> 
<input type="submit" value=" 提 交 " /> 
<input type="reset" value=" 重 置 " /> 
</p> 
</form> 
</body> 
</html> 
在 这 个 文件 中 使 用 如 下 语句 首先 声明 使 用 WebWork2 的 标签 


<%@ taglib prefix="ww" uri="webwork"%> 
然后 在 后 面 的 部 
<ww:if test="loginlnfo.errorMessage != null"> 
<font color="red"> 
<ww:property value="loginInfo.errorMessage"/> 
</font> 
</ww:if> 
让 标签 用 来 判断 是 否 有 错误 信息 , 如 果 有 就 使 用 property 
标签 答 显 示 出 来 。 
当 表 单 被 提交 时 , 浏览 器 会 以 两 个 文本 框 的 值 作为 参数 ， 
向 Web 请 求 以 login.action 命名 的 服务 .标准 HTTP 协议 中 并 
没有 .action 结尾 的 服务 资源 。 需 要 在 web.xml 中 加 以 设 定 ， 
这 将 在 配置 文件 部 分 介绍 。 
这 个 页 面 显示 如 图 20.3 所 示 。 
上 面 提 到 ， 如 果 用 户 的 用 户 名 和 密码 正确 ， 将 会 转发 到 
main.jsp 视图 ， 下 面 是 main.jsp 文件 的 完整 代码 : 


分 就 可 以 使 用 了 ， 在 这 个 代码 中 使 用 了 让 和 property 两 个 标签 ; 
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图 20.3 登录 信息 显示 页 面 
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<%@ taglib prefix="ww" uri="webwork"%> 
<html> 
<body> 
<p align="center">Login Success!</p> 
<p align="center">Welcome! 
<ww:property value="#session['username']"/> 
</p> 
<p align="center"> 
<!-- 一 -和 迭代 显示 所 有 的 消息 
<ww:iterator value="loginInfo.messages" status="index"> 
<ww:property/> 
</ww:iterator> 
</p> 
</body> 
</html> 


这 个 页 面 从 Session 中 获取 用 户 名 并 显示 处 理 ， 随 后 是 使 用 WebWork2 的 iterator 标签 
迭代 显示 所 有 的 消息 : 
<ww'iiterator value="loginlnfo.messages" status="index"> 


<ww:property/> 
</ww:iterator> 


2. 配置 文件 
上 面 讲 到 需要 在 web.xml 文件 中 配置 如 何 处 理 .action 结尾 的 服务 资源 , 这 是 通过 一 个 控 
制 器 Servlet 来 实现 的 ，web.xml 文件 的 完整 代码 如 下 : 


<?xml version="1.0"?> 
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app_2_3.dtd"> 


二 > 


<web-app> 
<display-name>Simple WebWork2 Application</display-name> 
<Servlet> 
<!------ 定 义 Servlet------> 
<servlet-name>webwork</servlet-name> 
<servlet-class>com.opensymphony.webwork.dispatcher.ServletDispatcher</servlet-class> 
<load-on-startup>1</load-on-startup> 
</servlet> 
<servlet-mapping> 
<!-- 一 -对 Servlet 进行 映射 ------> 
<servlet-name>webwork</servlet-name> 
<url-pattern>*.action</url-pattern> 
</servlet-mapping> 
<!-- 一 -声明 使 用 的 标签 库 一 一 > 
<taglib> 
<taglib-uri>webwork</taglib-uri> 
<taglib-location>/WEB-INF/lib/webwork-2.1.7.jar</taglib-location> 
</taglib> 
</web-app> 


从 上 面 的 配置 文件 可 以 看 到 ， 对 .action 结尾 服务 资源 进行 处 理 的 是 一 个 Servlet， 它 就 
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是 com.opensymphony.webwork.dispatcher.ServletDispatcher， 也 就 是 WebWork2 的 控制 器 ， 
关于 这 个 Servlet 在 后 面 会 详细 介绍 。 

在 配置 文件 中 除了 配置 一 个 Servlet 外 ， 还 定义 声明 了 一 个 Tablib， 也 就 是 在 index.jsp 
和 main.jsp 页 面 中 使 用 的 标签 库 。 

除了 Web 应 用 共同 的 配置 文件 外 ，WebWork2 还 需要 一 个 配置 文件 来 定义 页 面 导航 等 
信息 ， 也 就 是 xwork.xml 文件 ， 这 个 文件 必须 存放 在 Web 应 用 的 WEB-INF\classes 目录 下 ， 
本 实例 的 xwork.xml 文件 代码 如 下 : 


<!DOCTYPE xwork PUBLIC "-//OpenSymphony GroupWXWork 1.0//EN" 
"http://www.opensymphony.com/xwork/xwork-1.0.dtd"> 


<xwork> 
<include file="webwork-default.xml" /> 


<package name="cn.ac.ict" extends="webwork-default"> 
<!-- 一 -定义 拦截 器 -一 -> 
<default-interceptor-ref name="defaultStack" /> 
<!-- 一 -定义 action 组 件 ------> 
<action name="login" class="cn.ac.ict.LoginAction "> 
<result name="success" type="dispatcher"> 
<param name="location">/main.jsp</param> 
</result> 
<result name="loginfail" type="dispatcher"> 
<param name="location">/index.jsp</param> 
</result> 
<interceptor-ref name="params" /> 
<interceptor-ref name="model-driven"/> 
</action> 


</package> 


</xwork> 

在 这 个 配置 文件 中 通过 include 元 素 ， 可 以 将 其 他 配置 文件 导入 到 默认 配置 文件 
xwork.xml 中 ， 从 而 实现 良好 的 配置 划分 。 这 个 文件 导入 了 WebWork 提供 的 默认 配置 
webwork-default.xml (位 于 webwork.jar 的 根 路 径 ) 文件 。 

在 XWork 中 ， 可 以 通过 package 对 Action 进行 分 组 。 类 似 Java 中 package 和 class 的 
关系 。 为 可 能 出 现 的 同名 Action 提供 了 命名 空间 上 的 隔离 。 同 时 , package 还 支持 继承 关系 。 
在 这 里 的 定义 中 可 以 看 到 : 

extends="webwork-default" 

“webwork-default” 是 webwork-default.xml 文件 中 定义 的 package， 这 里 通过 继承 ， 
“default”package 自动 拥有 “webwork-default”package 中 所 定义 的 关系 。 
使 用 action 配置 元 素 ， 可 以 设 定 Action 的 名 称 和 对 应 实现 类 。 

通过 result 元 素 ， 可 以 定义 Action 返回 语义 ， 即 根据 返回 值 ， 决 定 处 理 模 式 以 及 响应 

界面 。 
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3. 控制 器 Action 

每 个 请 求 的 动作 都 对 应 于 一 个 相应 的 Action， 一 个 Action 是 一 个 独立 的 工作 单元 和 控 
制 命令 ， 它 必须 直接 或 者 间接 地 实现 Xwork 中 的 Action 接口 ， 实 现 Action 接口 的 execute() 
方法 。 在 本 例 中 使 用 的 一 个 Action 的 完整 代码 如 下 : 

package cn.ac.ict; 

import java.util.Map; 

import com.opensymphony.xwork.Action; 

import com.opensymphony.xwork.ActionContext; 


public class LoginAction implements Action { 
private final static String LOGIN_FAIL="loginfail"; 


Loginlnfo loginlnfo = new Loginlnfo(); 


public String execute() throws Exception { 
if 
(loginInfo.getUsername().equalslgnoreCase("JSPuser")&loginInfo.getPassword().equals("pass")) { 

// 将 当前 登录 的 用 户 名 保存 到 Session 

ActionContext ctx = ActionContext.getContext(); 

Map session = ctx.getSession(); 

session.put("username'",loginlnfo.getUsername()); 

// 出 于 演示 目的 ， 通 过 硬 编码 增加 通知 消息 以 供 显示 

loginlnfo.getMessages().add("Hello JSPuser ); 

loginlnfo.getMessages().add("Welcome Here!"); 
loginInfo.getMessages().add("Thanks!"); 

return SUCCESS; 

}else{ 
loginlnfo.setErrorMessage("Username/Password Error!"); 
return LOGIN_FAIL; 

} 
h 
public Loginlnfo getLoginlnfo(){ 
return loginlnfo; 
} 
} 


在 这 个 类 的 execute() 方 法 中 执行 了 一 些 简 单 的 处 理 ， 首 先 获取 Session 并 把 用 户 的 名 字 
作为 一 个 属性 保存 在 Session 中 ， 并 返回 一 些 欢迎 消息 。 

读者 可 能 注意 到 在 上 面 的 Action 中 使 用 了 一 个 LoginInfo 的 对 象 , 它 封装 了 所 有 用 户 请 
求 和 系统 响应 的 信息 ， 就 是 一 个 JavaBeans， 代 码 如 下 : 

package cn.ac.ict; 


import java.util.ArrayList; 
import java.util.List; 


public class Loginlnfo { 
//JavaBeans 的 属性 
private String password; 
private String username; 
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private List messages = new ArrayList(); 
private String errorMessage; 
/下 面 是 属性 的 设置 和 获取 方法 
public List getMessages() { 
return messages; 


} 
public String getErrorMessage() { 
return errorMessage; 


public void setErrorMessage(String errorMessage){ 
this.errorMessage = errorMessage; 


} 
public String getPassword() { 
return password; 


public void setPassword(String password) { 
this.password = password; 


! 
public String getUsername() { 
return username; 


public void setUsername(String username) { 
this.username = username; 


} 


20.1.5 编译 发 布 Web 应 用 


读者 按照 上 面 的 介绍 准备 好 所 有 的 文件 后 ， 就 可 以 按照 如 下 步骤 发 布 这 个 Web 应用: 

(1) 编译 Action 和 JavaBeans， 需 要 把 WebWork2 的 支持 JAR 文件 加 入 到 类 路 径 中 。 

(2) 准备 好 的 Web 应 用 的 结构 如 图 20.4 所 示 。 

(3) 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 :http://localhost:8080/20/， 随 意 输 
入 一 些 信息 后 提交 可 以 看 到 页 面 显 示 如 图 20.5 所 示 。 
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图 20.4 Web 应 用 目录 结构 图 20.5 错误 的 用 户 名 和 密码 


第 20 章 MVC 模式 实现 一 -WebWork2 。373。 


输入 正确 的 用 户 名 和 密码 : JSPuserpass， 提 交 后 ， 可 以 看 到 页 面 显示 如 图 20.6 所 示 。 
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图 20.6 正确 的 用 户 登录 后 的 欢迎 界面 


20.2 WebWork2 组 件 介绍 


WebWork2 首先 是 一 个 MVC 设计 模式 的 实现 ， 所 以 它 有 MVC 结构 的 共性 ， 同 时 它 也 
有 独特 的 特点 。WebWork2 中 比较 重要 的 几 个 概念 有 : 控制 器 (ServletDispatcher) 、Action 
上 下 文 (ActionContext) 、 动 作 (Action) 和 拦截 器 (Interceptor) 。 
WebWork2 的 基本 执行 流程 如 下 : 
ServletDispatcher 接 受 客户 端的 HTTP 请 求 ,将 HTTP 的 相关 参数 封装 后 ,再 传 给 XWork。 
XWork 解析 xwork.xml〔 配 置 文件 ) 并 根据 配置 ， 创 建 对 应 的 Action， 然 后 组 装 并 调用 相应 
的 拦截 器 ， 执 行 Action， 返 回执 行 结果 。 


从 注意 : 各 个 组 件 具体 完成 的 功能 见 后 面 几 节 对 各 个 组 件 的 介绍 
20.2.1 使 用 Action 组 件 响 应 客户 请 求 


Action 在 MVC 模式 中 担任 控制 部 分 的 角色 ， 在 WebWork 中 使 用 得 最 多 。 每 个 请 求 的 
动作 都 对 应 于 一 个 Action， 一 个 Action 是 一 个 独立 的 工作 单元 和 控制 命令 ， 它 必须 要 实现 
XWork 中 的 Action 接口 ， 实 现 Action 接口 的 execute() 方 法 。Action 接口 的 代码 如 下 : 

package com.opensymphony.xwork; 


import java.io.Serializable; 
public interface Action extends Serializable { 


public static final String SUCCESS = "success"; 
public static final String NONE = "none"; 

public static final String ERROR = "error"; 
public static final String INPUT = "input"; 

public static final String LOGIN = "login"; 


public String execute() throws Exception; 


} 
excute() 方 法 是 Action 类 中 最 重要 的 部 分 ， 它 执行 后 返回 String 类 型 的 值 ， 在 Action 中 
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返回 的 值 一 般 使 用 Action 接口 中 定义 的 标准 静态 字符 常量 。 例 如 , 前 面 的 LoginAction 返回 
的 就 是 SUCCESS 字符 常量 ,真正 的 值 当然 就 是 “success”， 它 与 XWork 配置 文件 中 result 
标签 name 的 值 是 相对 应 的 。 它 用 来 决定 execute0 方 法 执行 完成 之 后 , 调用 哪 一 种 返回 结果 。 
字符 常量 的 含义 如 下 : 
SUCCESS: 表示 Action 正确 地 执行 完成 ， 返 回 相应 的 视图 。 
NONE: 表示 Action 正确 地 执行 完成 ， 但 并 不 返回 任何 视图 。 
ERROR: 表示 Action 执行 失败 ， 返 回 到 错误 处 理 视 图 。 
INPUT: Action 的 执行 需要 从 前 端 界面 获取 参数 时 ，INPUT 就 是 代表 这 个 参数 输入 
的 界面 ， 一 般 在 应 用 中 会 对 这 些 参数 进行 验证 ， 如 果 验 证 没有 通过 ， 将 自动 返回 到 
该 视图 。 

口 LOGIN: Action 因为 用 户 没有 登录 的 原因 没有 正确 执行 ， 将 返回 该 登录 视图 ， 要 求 

用 户 进行 登录 验证 。 

Action 根据 FormBean 的 不 同 可 以 分 为 两 类 。 

口 Field-Driven (字段 驱动 的 ) Action。 

Action 将 直接 用 自己 的 字段 来 充当 FormBean 的 功能 ， 上 面 的 例子 就 是 使 用 这 种 方式 。 
它 一 般 在 页 面 表单 比较 简单 的 情况 下 使 用 ， 而 且 可 以 直接 用 域 对 象 作为 Action 的 字段 ， 这 
样 就 不 用 再 另 写 FormBean， 减 少 了 重复 代码 。 

口 Model-Driven 〈 模 型 驱动 的 ) Action。 

它 很 像 Struts 的 FormBean， 但 在 WebWork 中 ， 只 要 普通 Java 对 象 就 可 以 充当 模型 前 
分 。 Model-Driven 〈 模 型 驱动 的 ) Action 要 求 Action 实现 com.opensymphony.xwork. 
ModelDriven 接口 ， 它 有 一 个 方法 : Object getModel0;， 用 这 个 方法 返回 模型 对 象 就 可 以 了 。 


OODODD 


20.2.2 ”使 用 ActionContext 获取 用 户 请 求 信息 


ActionContext (com.opensymphony.xwork.ActionContext) 是 Action 执行 时 的 上 下 文 ， 
上 下 文 可 以 看 作 是 一 个 容器 (这 里 的 容器 是 一 个 Map 对 象 ) ， 它 存放 的 是 Action 在 执行 时 
需要 用 到 的 对 象 , 有 请 求 的 参数 (Parameter)、 会 话 (Session)、Servlet 上 下 文 (ServletContext) 
和 本 地 化 (Locale) 信息 等 。 例 如 ， 如 果 需 要 取得 request 请 求 参数 “product_ id” 的 值 就 要 
按照 如 下 步骤 操作 ; 

ActionContext context = ActionContext.getContext(); 

Map params = context.getParameters(); 

String product id = (String) params.get("product_id"); 

先 获取 一 个 ActionContext 的 对 象 Context, 然后 从 Context 对 象 中 获取 所 有 的 请 求 参数 ， 
得 到 一 个 Map 对 象 (WebWork 框架 将 与 Web 相关 的 很 多 对 和 象 重新 进行 了 包装 ) ， 然 后 从 
这 个 Map 对 象 中 就 可 以 得 到 需要 的 请 求 参数 值 。 

在 每 次 执行 Action 之 前 都 会 创建 新 的 ActionContext，ActionContext 是 线程 安全 的 ， 也 
就 是 说 在 同一 个 线程 中 ActionContext 里 的 属性 是 惟一 的 ,这样 Action 就 可 以 在 多 线程 中 使 
用 。 通 过 ActionContext 的 静态 方法 : ActionContext.getContext0 来 取得 当前 的 ActionContext 
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对 象 。 

如 果 Action 需要 直接 与 JavaServlet 的 HttpSession、HttpServletRequest 等 一 些 对 象 进行 
操作 ， 就 要 使 用 ServletActionContext。 

ServletActionContext (com.opensymphony.webwork. ServletActionContext) ， 这 个 类 直 
接 继承 了 ActionContext， 它 提供 了 直接 与 JavaServlet 相关 对 象 访问 的 功能 ， 它 可 以 取得 的 
对 象 有 : 
javax.servlet.http.HttpServletRequest: HTTPservlet 请 求 对 象 。 
javax.servlet http.HttpServletResponse: HTTPservlet 相应 对 象 。 
javax.servlet.ServletContext: Servlet 上 下 文 信息 。 
javax.servlet.ServletConfig: Servlet 配置 对 象 。 
javax.servlet.jsp.PageContext: HTTP 页 面 上 下 文 。 


DOOODODDO 


20.2.3 ”使 用 ServletDispatcher 分 发 客户 请 求 


ServletDispatcher 是 默认 的 处 理 Web HTTP 请 求 的 调度 器 ， 它 是 一 个 JavaServlet， 是 
WebWork 框架 的 控制 器 。 

所 有 对 Action 调用 的 请 求 都 将 通过 这 个 ServletDispatcher 调度 。 这 将 在 web.xml 中 配置 
ServletDispatcher 时 指定 ， 使 所 有 对 WebWork 的 Action〔 默 认 的 是 .action 的 后 级 ) 的 请 求 
都 对 应 到 该 调度 的 JavaServlet 中 。 

ServletDispatcher 接受 客户 端的 HTTP 请 求 ， 将 JavaServlet 的 相关 对 象 进行 包装 ， 然 后 
传 给 XWork 框架 ，ServletDispatcher 的 主要 功能 调用 如 下 : 

1. init0 方 法 

init0 方 法 在 服务 器 启动 时 调用 ， 它 要 完成 的 工作 如 下 : 

口 初始 化 Velocity 引擎 。 

口 检查 是 否 支 持 配置 文件 重新 载 入 功能 。 如 果 webwork.configuration.xml.reload 设置 
为 true, 每 个 request 请 求 都 将 重新 装载 xwork.xml 配置 文件 。 这 在 开发 环境 中 特别 
方便 ， 但 在 生产 环境 必须 设置 为 false。 

口 设置 一 些 文件 上 传 的 信息 ， 比 如 : 上 传 的 临时 目录 、 上 传 的 最 大 字 节 等 。 都 设置 在 
webwork.properties 文件 中 ， 如 果 在 classpath 中 没有 找到 ， 它 会 读 取 默 认 的 
default.properties 。 

2. service() 方 法 

每 次 客户 端的 请 求 都 将 调用 service0 方 法 ， 它 需要 完成 的 工作 包括 : 

口 通过 request 请 求 取得 Action 的 命名 空间 (namespace， 与 xwork.xml 配置 文件 中 
package 标签 的 name 对 应 ) ， 例 如 : 

/foo/bar/MyAction.action， 取 得 的 命名 空间 为 /foo/bar 


在 xwork.xml 配置 文件 中 应 该 有 这 一 段 : 
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<package name="foo.bar" ...... 
口 根据 Servlet 请 求 的 Path， 解 析出 要 调用 该 请 求 的 Action 的 名 字 (actionName) 。 
口 创建 Action 上 下 文 (extraContext) 。 
前 面 介绍 的 ActionContext 上 下 文 的 对 象 ， 就 是 在 这 里 设置 的 。 它 将 JavaServlet 相关 的 
对 象 进行 包装 ， 放 入 到 这 个 Map 对 象 中 ， 并 返回 这 个 Map 对 象 。 
口 根据 前 面 获得 的 namespace、actionName、extraContext( 一 个 Map 对 象 ) ， 创 建 一 
个 ActionProxy， 代 码 如 下 : 


ActionProxy proxy = ActionProxyFactory.getFactory().createActionProxy(namespace,actionName， 
extraContext); 


默认 的 proxy 是 com.opensymphony.xwork.DefaultActionProxy。 

口 执行 proxy 的 execute() 方 法 。 

这 个 方法 最 核心 的 语句 是 : retCode = invocation.invoke0;，invocation 对 象 的 invoke0 方 
法 遍历 并 执行 这 个 Action 对 应 的 所 有 拦截 器 ， 然 后 执行 Action 对 应 的 方法 (默认 的 是 
execute0) ， 根 据 Action 执行 的 返回 值 去 调用 相应 的 Result〈 返 回 结果 处 理 ) 的 方法 。 


20.2.4 使 用 Interceptor (拦截 器 ) 框架 


Interceptor (拦截 器 ) 将 Action 共用 的 行为 独立 出 来 ,在 Action 执行 前 后 运行 。 它 的 执 
行 类 似 于 Servlet 过 滤器 。 

Interceptor 将 很 多 功能 从 Action 中 独立 出 来 ， 大 量 减少 了 Action 的 代码 ， 独 立 出 来 的 
行为 具有 很 好 的 重用 性 。XWork、WebWork 的 许多 功能 都 是 由 Interceptor 实现 的 ， 可 以 在 
配置 文件 中 组 装 Action 用 到 的 Interceptor， 它 会 按照 指定 的 顺序 ， 在 Action 执行 前 后 运行 。 
Interceptor 在 框架 中 的 应 用 如 图 20.7 所 示 。 
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图 20.7 WebWork2 框架 
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当 客 户 提交 对 Aciton 的 请 求 时 ，ServletDispatcher 会 根据 客户 的 请 求 去 调度 并 执行 相应 
的 Action。 在 Action 执行 之 前 ， 调 用 被 Interceptor 截取 ， 也 就 是 Interceptor 在 Action 执行 
前 后 运行 。 

所 有 XWork 提供 的 Interceptor 都 在 webwork-default 中 有 定义 , 使 用 Interceptor 可 以 完 


成 计时 、 


输出 日 志和 对 用 户 进行 验证 等 功能 ， 框 架 中 给 开发 者 供 了 很 多 实用 的 Interceptor， 


它们 的 具体 功能 如 下 : 


口 
口 
口 


timer: 记录 Action 执行 的 时 间 ， 并 作为 日 志 信息 输出 。 

logger: 在 日 志 信息 中 输出 要 执行 的 Action 信息 。 

chain : 将 前 一 个 执行 结束 的 Action 属性 设置 到 当前 的 Action 中 。 它 被 用 在 

ResultType 为 "chain ”指定 结果 的 Action 中 ,该 结果 Action 对 象 会 从 OgnlValueStack 

中 获得 前 一 个 Action 对 应 的 属性 ， 它 实现 Action 链 之 间 的 数据 传递 。 

static-params: 将 xwork.xml 配置 文件 中 定义 的 Action 参数 ， 设 置 到 对 应 的 Action 

中 。Action 参数 使 用 <param 户 标 签 ， 是 <action /> 标签 的 直接 子 元 素 。 这 里 定义 的 

Action 类 必须 实现 com.opensymphony.xwork.config.entities. Parameterizable 接口 。 

params: 将 request 请 求 的 参数 设置 到 相应 Action 对 象 的 属性 中 。 

model-driven: 如 果 Action 实现 ModelDriven 接口 ， 它 将 getModel0 取 得 的 模型 对 

象 存 入 OgnlValueStack 中 。 

component: 激活 组 件 功能 支持 , 让 注册 过 的 组 件 在 当前 Action 中 可 用 , 即 为 Action 

提供 IoC〔 依 赖 倒转 控制 ) 框架 的 支持 。 

token: 核对 当前 Action 请 求 request) 的 有 效 标识 ， 防 止 重复 提交 Action 请 求 
(request) 。 

token-session: 功能 同上 ， 但 当 提 交 无 效 的 Action 请 求 标识 时 ， 它 会 将 请 求 数据 保 

存 到 Session 中 。 

validation: 实现 使 用 XML 配置 文件 ({Action}-validation.xml) 对 Action 属性 值 进 

行 验证 ， 详 细 请 看 后 面 介绍 的 验证 框架 。 

workflow: 调用 Action 类 的 验证 功能 ， 假 设 Action 使 用 ValidationAware 实现 验证 
(ActionSupport 提供 此 功能 ), 如 果 验 证 没有 通过 , workflow 会 将 请 求 返 回 到 input 

视图 (Action 的 <result /> 中 定义 的 )。 

servlet-config: 提供 Action 直接 对 HttpServletRequest 或 HttpServletResponse 等 

JavaServlet api 的 访问 ，Action 要 实现 相应 的 接口 ， 例 如 : ServletRequestAware 或 

ServletResponseAware 等 。 如 果 必 须要 提供 对 JavaServlet API 的 访问 ， 建 议 使 用 

ServletActionContext， 在 前 面 ActionContext 章节 中 有 介绍 。 

prepare: 在 Action 执行 之 前 调用 Action 的 prepare() 方 法 , 这 个 方法 是 用 来 准备 Action 

执行 之 前 要 做 的 工作 。 它 要 求 Action 必须 实现 com.opensymphony.xwork. Preparable 

接口 。 

conversionError: 用 来 处 理 框架 进行 类 型 转化 〈Type Conversion) 时 的 出 错 信息 。 

它 将 存储 在 ActionContext 中 的 类 型 转化 〈Type Conversion) 错误 信息 转化 成 相应 

的 Action 字段 的 错误 信息 保存 在 堆栈 中 。 根 据 需要 可 以 将 这 些 错 误 信 息 在 视图 中 
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显示 出 来 。 
除了 使 用 系统 提供 的 拦截 器 ， 也 可 以 自 定 义 拦截 器 ， 使 用 自 定义 拦截 器 的 步骤 如 下 : 
口 创建 一 个 自己 需要 的 Interceptor 类 ， 它 必须 实现 com.opensymphony.xwork. 
interceptor.Interceptor 接口 。 
口 在 配置 文件 (xwork..xml) 中 申明 这 个 Interceptor 类 ， 它 放 在 标签 <interceptor /> 中 ， 
并 把 interceptor 人 标签 嵌入 在 <interceptors 人 > 标签 内 部 。 
口 创建 mterceptor 栈 , 使 用 标签 <interceptor-stack />, 让 一 组 Interceptor 可 以 按 次 序 调 
用 (可 选 ) 。 
指定 Action 所 要 用 到 的 Interceptor, 可 以 用 <interceptor-ref /> 或 <default-interceptor-ref /> 
标签 。<interceptor-ref /> 标签 指定 某 个 Action 所 用 到 的 Interceptor， 如 果 Action 没有 被 用 
<interceptor-ref /> 指定 Interceptor， 它 将 使 用 <default-interceptor-ref /> 指定 的 Interceptor。 


20.2.5 ”使 用 验证 框架 验证 用 户 输入 


WebWork2 提供 了 在 Action 执行 之 前 对 输入 数据 验证 的 功能 ， 它 使 用 了 其 核心 XWork 
的 验证 框架 。 主 要 提供 了 如 下 功能 : 

口 可 配置 的 验证 文件 。 它 的 验证 文件 是 一 个 独立 的 XML 配置 文件 ， 对 验证 的 添加 、 

修改 时 只 需要 修改 配置 文件 ， 无 须 编译 任何 的 Class。 
口 验证 文件 和 被 验证 的 对 象 无 关联 。 验 证 对 象 是 普通 的 JavaBeans 即 可 (可 以 是 
FormBean、 域 对 象 等 ) ， 不 需 实现 任何 额外 的 方法 或 继承 额外 的 类 。 

口 多 种 不 同 的 验证 方式 。 因 为 验证 功能 是 可 以 继承 的 , 所 以 可 以 用 多 种 不 同 的 方式 指 
定 验证 文件 ， 比 如 : 通过 父 类 的 Action、 通 过 Action、 通 过 Action 的 方法 、 通 过 
Action 所 使 用 的 对 象 等 。 

口 强大 的 表达 式 验证 。 它 使 用 了 OGNL (Object-Graph Navigation Language， 是 一 种 

功能 强大 的 表达 式 语 言 ) 的 表达 式 语 言 ， 提 供 强 大 的 表达 式 验证 功能 。 

口 同时 支持 服务 器 端 和 客户 端 验证 。 

WebWork 为 不 同 的 验证 要 求 提 供 不 同 的 验证 类 型 。 一 个 验证 类 型 ， 一 般 是 有 一 个 类 来 
提供 。 这 个 类 必须 实现 接口 : com.opensymphony.xwork.validator.Validator， 但 我 们 在 写 自 己 
的 验证 类 型 时 ,无 须 直接 实现 Validator 接口 , 它 有 抽象 类 可 供 直接 使 用 ,如 ValidatorSupport、 
FieldValidatorSupport 等 。 

验证 类 型 在 使 用 之 前 ， 必 须要 在 ValidatorFactory (com.opensymphony.xwork.validator. 
ValidatorFactory) 中 注册 。 可 以 有 两 种 方法 实现 验证 类 型 的 注册 。 

口 “ 写 程序 代码 进行 注册 , 它 使 用 ValidatorFactory 类 的 静态 方法 :registerValidator(String 

name, String className)。 

口 使 用 配置 文件 validators.xml 进行 注册 , 要 求 把 文件 validators.xml 放 到 ClassPath 的 

根 目录 中 (/WEB-INF/classes)。 
在 实际 开发 中 ， 一 般 都 使 用 第 二 种 注册 方法 。 
如 果 Action 要 使 用 验证 框架 的 验证 功能 , 它 必 须 在 配置 文件 中 指定 拦截 器 “validation ”， 
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它 的 定义 如 下 : 

<interceptor name="validation" class="com.opensymphony.xwork.validator.Validationlnterceptor />. 

验证 文件 必须 以 ActionName-validation.xml 格式 命名 ， 它 必须 被 放置 到 与 这 个 Action 
相同 的 包 中 。 也 可 以 为 这 个 Action 通过 别名 的 方式 指定 验证 文件 ， 它 的 命名 格式 为 : 
ActionName-aliasname-validation.xml。 其 中 “ActionName” 是 Action 的 类 名 ; “aliasname” 
是 在 配置 文件 (xwork.xml) 中 定义 这 个 Action 所 用 到 的 名 称 。 这 样 ， 同 一 个 Action 类 ， 在 
配置 文件 中 的 不 同 定义 就 可 以 对 应 不 同 的 验证 文件 。 验 证 框架 也 会 根据 Action 的 继承 结构 
去 查找 Action 的 父 类 验证 文件 ， 如 果 找 到 它 会 去 执行 这 个 父 类 的 验证 。 

在 20.3 节 中 介绍 的 例子 就 使 用 了 这 样 的 一 个 验证 。 


20.2.6 配置 XWork 


XWork 配置 文件 是 以 XWork 命名 的 .xml 文件 ， 它 必须 放 到 类 路 径 〈classPath) 的 根 目 
录 一 一 VEB-INF\classes 目录 中 。 

这 个 文件 定义 了 Action 、Interceptor、Result 的 配置 和 相互 之 间 的 映射 。 下 面 是 一 个 
XWork 配置 文件 的 例子 : 

<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN" 

"http://www.opensymphony.com/xwork/xwork-1.0.dtd"> 


<xwork> 
<!-- Include webwork defaults (from WebWork-2.1 JAR). --> 
<include file="webwork-default.xml" /> 


<!-- 配置 默认 的 包 --> 
<package name="cn.ac.ict" extends="webwork-default"> 
<!-- 定 义 默认 的 拦截 器 栈 --> 
<default-interceptor-ref name="defaultStack" /> 
<!-- 定 义 action 组 件 --> 
<action name="registerSupport" class="cn.ac.ict.RegisterAction" > 
<result name="success" type="dispatcher"> 
<param name="location">/register-resultjsp</param> 
</result> 
<result name="input" type="dispatcher"> 
<param name="location">/registerSupportjsp</param> 
</result> 
<interceptor-ref name="validationWorkflowStack"/> 
</action> 


</package> 


</xwork> 


在 xwork.xml 文件 中 可 以 配置 如 下 元 素 : 
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(1) XWork: XWork 元 素 配置 文件 的 所 有 内 容 ， 它 是 配置 文件 的 根 元 素 ， 它 的 直接 子 
标签 有 <package> 和 <include>， 例 如 在 上 面 例子 中 的 XWork 元 素 就 包含 一 个 <package> 元 素 
和 一 个 <include> 元 素 。 

(2) Package: Action、Interceptor、Result 是 在 此 标签 中 定义 ， 它 需要 设置 的 属性 如 
表 20.1 所 示 。 


表 20.1 Package 元 素 属性 


属 性 描述 
name 用 来 标识 package 的 名 称 
extends 继承 它 所 扩展 的 package 配 置信 息 
namespace 指定 package 的 命名 空间 ， 默 认 是 "" 
abstract 声明 package 是 抽象 的 


(3) Result-type: 用 来 定义 输出 结果 类 型 的 Class， 使 用 名 一 值 对 的 形式 来 定义 。 自 己 
写 的 输出 结果 类 型 也 必须 在 这 里 定义 。 

(4) Interceptors: 它 是 一 个 简单 的 <interceptors> 标 签 ， 程 序 中 需要 的 Interceptor 和 
Interceptor-stack 都 在 此 标签 内 定义 。 

口 Interceptor: 用 来 定义 拦截 器 。 它 的 定义 非常 简单 ， 使 用 名 一 值 对 的 形式 。 

口 Interceptor-stack: 用 来 将 上 面 定义 的 Interceptor 组 织 成 堆栈 的 形式 ， 这 样 就 可 以 创 

建 一 组 标准 的 Interceptor, 让 它 按照 顺序 执行 。 在 Action 中 直接 引用 这 个 Interceptor 
堆栈 就 可 以 了 ， 不 用 逐个 Interceptor 去 引用 。 

(5) Global-results: 它 允 许 定义 全 局 的 输出 结果 (global result) ， 比 如 登录 页 面 、 操 
作 错 误 处 理 页 面 。 只 要 继承 它 所 在 的 package， 这 些 输出 结果 都 是 可 见 的 。 

(6) Action: 用 来 配置 Action 的 名 称 Cname) 和 它 对 应 的 Class。 通 过 这 个 Action 的 
名 称 和 它 所 在 package 的 namespace 去 配置 文件 中 取得 这 个 Action 的 配置 信息 。 它 可 以 通过 
<param> 来 设置 参数 ，Action 在 执行 时 会 取得 配置 文件 中 设置 的 参数 (通过 拦截 器 
StaticParametersInterceptor ) 。 

Action 可 以 配置 一 个 或 多 个 输出 结果 (result) 。 一 个 输出 结果 的 名 称 对 应 于 Action 执 
行 完 成 返回 的 字符 串 。<result> 标 签 的 type 属性 对 应 前 面 定 义 过 的 result-type， 说 明 reslut 
的 类 型 ， 例 如 在 上 面 的 例子 中 定义 了 名 为 registerSupport 的 Action: 

<action name="registerSupport" class="cn.ac.ict.RegisterAction" > 
<result name="success" type="dispatcher"> 
<param name="location">/register-result.jsp</param> 
</result> 
<result name="input" type="dispatcher > 
<param name="location">/registerSupportjsp</param> 
</result> 
<interceptor-ref name="validationWorkflowStack"/> 
</action> 


可 见 ， 在 这 个 Action 中 就 定义 了 两 个 result 元 素 〈 一 个 名 为 success， 一 个 名 为 input) 
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和 一 个 默认 的 拦截 器 。 

(7) Include: xwork.xml 文件 可 以 被 分 成 好 几 个 不 同 的 文件 ，xwork.xml 通过 <include> 
标签 引用 被 包含 的 文件 ， 例 如 : <include file="webwork-default.xml"/>。 被 包含 的 文件 必须 
是 package 标签 中 的 内 容 。 如 果 要 继承 被 包含 文件 的 package， 必 须 将 <include> 标 签 放 在 其 
上 面 ， 因 为 配置 文件 是 按照 由 上 而 下 的 顺序 解析 的 。 


20.3 使 用 WebWork2 开发 产品 录入 系统 一 一 WebWork2 
实例 


在 本 节 介 绍 一 个 简单 的 产品 录入 系统 ， 重 点 演示 Webwork2 验证 框架 的 使 用 。 
20.3.1 创建 Action 组 件 


下 面 介 绍 本 实例 使 用 的 Action 组 件 ， 它 通过 继承 ActionSupport 类 简介 实现 了 Action 
接口 ， 其 代码 如 下 : 


package cn.ac.ict; 
import com.opensymphony.xwork.ActionSupport; 
public class ProductlnputAction extends ActionSupport{ 
private Product product= new Product(); 
public Product getProduct(){ 
return this.product'; 


} 
// 不 作 细 致 处 理 ， 返 回 SUCCESS 
public String execute(){ 

return SUCCESS; 


} 
在 这 个 类 中 使 用 了 一 个 Product 对 象 ， 它 的 代码 如 下 : 


package cn.ac.ict; 
import java.io.Serializable; 
import java.util.Date ; 
public class Product implements Serializable{ 
// 下 面 是 JavaBeans 的 属性 
private String pname:; 
private String pcomp; 
private Date pmadeyear; 
private float price; 
private int amount; 


public Product(){ 
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> 
// 下 面 是 JavaBeans 属性 的 设置 和 获取 方法 
public String getPname(){ 
return pname; 
1 
public String getPcomp(){ 
return pcomp; 


} 


public Date getPmadeyear(}{ 
return pmadeyear; 


} 

public float getPrice(){ 
return price; 

} 


public int getAmount(){ 
return amount; 


} 


public void setPname(String productname}{ 
pname = productname; 


public void setPcomp(String productcomp}{ 
pcomp = productcomp; 


} 


public void setPmadeyear(Date madeyear){ 
pmadeyear = madeyear; 


} 
public void setPrice(float price){ 
this.price = price; 


} 


public void setAmount(int pamount}{ 
amount = pamount; 


} 


} 
这 里 使 用 的 类 都 很 简单 就 不 介绍 了 。 


20.3.2 创建 视图 组 件 


在 本 实例 中 使 用 了 两 个 视图 : productinputjsp〈 产 品 信息 输入 界面 ) 和 productinput 
resultjsp 《产品 信息 输入 结果 页 面 )， 下 面 分 别 介绍 : 

1. 编写 productinput.jsp 文件 一 一 产品 信息 输入 页 面 

<%@ taglib uri="webwork" prefix="ww" %> 


第 20 章 MVC 模式 实现 一 WebWork2 “383 。 


<html> 

<head><title>Product Input Example Using WebWork2</title></head> 

<body> 

<table border=0 width=97%> 

<tr><td align="left"> 
<ww:form name=" 'test' " action=" "ProductinputSupport.action' " method=" 'POST' "> 
<ww:textfield label=" 'Product Name' " name=" 'product.pname' " required="true"/> 

<ww:textfield label=" 'Product Made Where' " name=" 'product.pcomp' " required 


="true"/> 
<ww:textfield label=" 'Made Date' " name=" "product.pmadeyear' " required="true"/> 
<ww:textfield label=" 'Price' " name=" 'product.price' "/> 
<ww:textfield label=" 'Amount " name=" 'product.amount' " required="true"/> 
<ww:submit value=" 'Submit' "/> 
</ww:form> 
</td></tr> 
</table> 
</body> 
</html> 


这 是 产品 录入 界面 ， 提 供 一 些 输入 框 来 接受 用 户 的 输入 ， 这 个 页 面 显 示 如 图 20.8 所 示 。 
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图 20.8 产品 录入 界面 


2. 编写 productinput_result.jsp 文件 一 一 产品 信息 输入 结果 显示 页 面 
这 个 页 面 显示 产品 输入 的 结果 : 


<%@ taglib prefix="ww" uri="webwork" %> 
<html> 
<head><title>Register result</title></head> 
<body> 
<table border=0 width=97%> 
<tr> 
<td align="left"> 
Congratulation,Input Product success!<p> 
Product name:<ww:property value="product.pname"/><br> 
Product Made Where:<ww:property value="product.pcomp"/><br> 
Made Date:<ww:property value="product.pmadeyear"/><br> 
Price:<ww:property value="product.price"/><br> 
Amount:<ww:property value="product.amount"/><br> 
</td> 
</tr> 


到 


“384 。 JSP 网 络 开发 技术 及 整合 应 用 


</table> 
</body> 
</html> 


20.3.3 ”验证 框架 


根据 前 面 的 介绍 ， 在 本 实例 中 使 用 验证 框架 需要 按照 如 下 步骤 进行 : 
(1) 使 用 第 二 种 方法 进行 验证 注册 一 一 使 用 配置 文件 validators.xml 进行 注册 ， 要 求 
把 文件 validators.xml 放 到 classpath 的 根 目 录 (/WEB-INF/classes) 中。 
(2) 本 实例 中 使 用 的 validators.xml 文件 的 内 容 如 下 : 
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 
1.0//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.dtd"> 


<validators> 
<validator name="required" 
class="com.opensymphony.xwork.validator.validators.RequiredFieldValidator"/> 


<validator name="requiredstring" 
class="com.opensymphony.xwork.validator.validators.RequiredStringValidator"/> 

<validator name="int" 
class="com.opensymphony.xwork.validator.validators.IntRangeFieldValidator /> 


<validator name="date" 
class="com.opensymphony.xwork.validator.validators.DateRangeFieldValidator"/> 

<validator name="expression" 
class="com.opensymphony.xwork.validator.validators.ExpressionValidator"/> 


<validator name="fieldexpression" 
class="com.opensymphony.xwork.validator.validators.FieldExpressionValidator"/> 


<validator name="email" 
class="com.opensymphony.xwork.validator.validators.EmailValidator"/> 


<validator name="url" 
class="com.opensymphony.xwork.validator.validators.URLValidator"/> 


<validator name="Vvisitor" 
class="com.opensymphony.xwork.validator.validators.VisitorFieldValidator"/> 


<validator name="conversion" 
class="com.opensymphony.xwork.validator.validators.ConversionErrorFieldValidator"/> 


</validators> 
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(3) 编写 本 实例 使 用 的 验证 文件 ， 它 的 名 字 是 ProductInputAction-validation.xml， 前 
一 部 分 的 名 字 和 Action 的 类 名 是 一 致 的 。 


<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0WEN"”"http:/www. 
opensymphony.com/xwork/xwork-validator-1.0.dtd"> 
<validators> 
<!-- 一 -一 -产品 名 称 为 空 时 提示 的 信息 一 -一 -一 -> 
<field name="product.pname"> 
<field-validator type= "requiredstring"> 
<message>You must enter a value for 'Product Name'.</message> 
</field-validator> 
</field> 
<!-- 一 -一 -产品 的 生产 企业 为 空 时 输出 的 提示 信息 -一 -一 -一 > 
<field name="product.pcomp"> 
<field-validator type= "requiredstring"> 
<message>You must enter a value for 'Product Made Where'.</message> 
</field-validator> 
</field> 
<field name="product.pmadeyear"> 
<!-------- 日 期 输入 错误 时 的 提示 信息 -----------> 
<field-validator type="date"> 
<message>You must enter a right Date value for 'Made Date'.</message> 
</field-validator> 
</field> 
<!-- 一 -一 -产品 数量 输入 的 范围 出 现 错误 时 提示 的 信息 -一 -一 -一 -> 
<field name="product.amount"> 
<field-validator type="int"> 
<param name="min">6</param> 
<param name="max">100</param> 
<message>Amount must be between S${min} and S${max}, current value is 
S${product.amount}.</message> 
</field-validator> 
</field> 


</validators> 

(4) 如 果 用 户 输 入 的 数据 验证 没有 通过 , 需 重新 返回 输入 页 面 , 并 给 出 错误 信息 提示 。 
拦截 器 栈 “validationWorkflowStack” 实 现 了 这 个 功能 。 它 首先 验证 用 户 输入 的 数据 ， 如 果 
验证 没有 通过 将 不 执行 Action 的 execute() 方 法 ， 而 是 将 请 求 重新 返回 到 输入 页 面 。 


20.3.4 ”编写 配置 文件 


本 实例 使 用 的 web.xml 文件 与 本 章 第 一 节 的 例子 中 的 web.xml 文件 是 一 样 的 ， 这 昌 
不 介绍 了 ， 下 面 是 WebWork2 配置 文件 的 xwork.xml: 


曙 
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<!DOCTYPE xwork PUBLIC "-//OpenSymphony Group//XWork 1.0//EN" 
"http://www.opensymphony.com/xwork/xwork-1.0.dtd"> 


<xwork> 
<include file="webwork-default.xml" /> 
<!-- 配置 默认 的 包 --> 
<package name="cn.ac.ict" extends="webwork-default"> 
<default-interceptor-ref name="defaultStack" /> 
<action name="ProductlnputSupport" class="cn.ac.ict.ProductinputAction" > 
<result name="success" type="dispatcher"> 
<param name="location">/productinput_result.jsp</param> 
</result> 
<result name="input" type="dispatcher"> 
<param name="location">/productinput.jsp</param> 
</result> 
<interceptor-ref name="validationWorkflowStack"/> 
</action> 


</package> 
</xwork> 
上 面 的 配置 文件 中 使 用 了 验证 拦截 器 栈 来 显示 错误 信息 : 


<interceptor-ref name="validationWorkflowStack"/> 


20.3.5 “运行 基于 WebWork2 的 Web 应 用 


读者 按照 上 面 的 介绍 准备 好 所 有 的 文件 后 ， 就 可 以 按照 如 下 步骤 发 布 这 个 Web 应 用 : 
(1) 编译 Action 和 JavaBeans， 需 要 把 WebWork2 的 支持 JAR 文件 加 入 到 类 路 径 中 。 
(2) 准备 好 的 Web 应 用 的 结构 如 图 20.9 所 示 。 
(3) 启动 Tomcat， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/webwork2/ 
productinputjsp， 输 入 后 提交 可 以 看 到 页 面 如 图 20.10 所 示 。 
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图 20.9 Web 应 用 的 目录 结构 图 20.10 验证 框架 的 实例 


第 20 章 MVC 模式 实现 一 一 WebWork2 “387 


可 以 看 到 如 果 用 户 不 输入 数据 或 者 输入 错误 的 数据 都 会 提示 错误 ， 这 些 错 误 信 息 就 是 
在 ProductInputAction-validation.xml 文件 中 定义 的 。 
(4) 正确 地 输入 数据 并 提交 后 ， 可 以 看 到 页 面 显示 如 图 20.11 所 示 。 
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图 20.11 通过 验证 框架 
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20.4 小 结 


在 第 19 章 介绍 了 Struts 框架 后 ， 本 章 又 介绍 了 WebWork2。WebWork2 建立 在 XWork 
基础 之 上 ， 处 理 HTTP 的 响应 和 请 求 ， 使 得 它 与 Servlet 的 request 和 response 很 好 地 解 烛 。 

WebWork2 中 的 一 些 概念 如 验证 器 、 拦 截 器 等 希望 读者 能 重点 掌握 ， 难 点 在 于 了 解 
WebWork2 的 工作 原理 ， 读 者 在 阅读 本 章 基 本 了 解 该 技术 的 基础 上 应 该 多 加 实践 。 
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Java Server Faces (JSF) 是 一 种 MVC 应 用 程序 框架 ， 用 于 创建 基于 Web 的 用 户 界面 。 
如 果 读 者 熟悉 Struts〈 一 种 流行 的 开放 源 代码 的 基于 JSP 的 Web 应 用 程序 框架 ， 在 本 书 的 
“MVC 模式 实现 一 一 Struts” 一 章 中 有 介绍 ) 和 Swing (针对 桌面 应 用 程序 的 标准 Java 用 
户 界面 ) ， 就 可 以 将 Java Server Faces 想象 成 这 两 种 框架 的 组 合 。 与 Struts 一 样 ，JSF 通过 
一 个 控制 器 Servlet 来 提供 Web 应 用 程序 生命 周期 管理 ; 也 与 Swing 一 样 ，JSF 提供 了 一 个 
带 有 事件 处 理 和 组 件 呈 现 〈rendering) 的 丰富 组 件 模型 。 


21.1 快速 体验 Java Server Faces 一 一 使 用 Java Server 
Faces 开发 的 简单 例子 


21.1.1 Java Server Faces 技术 介绍 


Java Server Faces (JSF) 是 一 种 用 于 构建 Web 应 用 程序 的 新 标准 Java 框架 。 它 提供 了 

-种 以 组 件 为 中 心 来 开发 Java Web 用 户 界面 的 方法 ，JSF 开发 可 以 简单 到 只 需 将 用 户 界面 

(UTD 组 件 拖 放 到 页 面 上 ， 丰富 而 强健 的 JSF API 为 “系统 开发 人 员 ” 提 供 了 无 与 伦比 的 功 
能 和 编程 灵活 性 。 

JSF 通过 将 构建 良好 的 模型 一 视图 一 控制 器 (MVC) 设计 模式 集成 到 它 的 体系 结构 中 ， 
确保 了 应 用 程序 具有 更 高 的 可 维护 性 。 最 后 , 由 于 JSF 是 通过 Java Community Process (JCP) 
开发 的 一 种 Java 标准 ， 因 此 开发 工具 供应 商 完全 能 够 为 Java Server Faces 提供 易于 使 用 的 、 
高 效 的 可 视 化 开发 环境 。 

JSF 减轻 了 开发 基于 Web 的 应 用 程序 的 工作 量 ， 因 为 它 具 有 如 下 的 特性 : 

口 可 以 通过 一 组 标准 的 、 可 重用 的 服务 器 端 组 件 来 创建 用 户 界面 。 
提供 了 一 组 JSP 标签 以 访问 这 些 组 件 。 
在 表单 重新 显示 时 ， 透 明 地 保存 状态 信息 并 重新 填充 表单 。 
提供 了 实现 自 定义 组 件 的 框架 。 
封装 了 事件 处 理 和 组 件 呈 现 , 以 便 用 户 可 以 使 用 标准 的 JSF 组 件 或 自 定义 组 件 来 支 
持 除 HTML 之 外 的 标记 语言 。 

口 工具 开发 商 可 以 开发 针对 标准 Web 应 用 程序 框架 的 IDE。 


DOOOoOo 
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21.1.2 ”建立 Java Server Faces 开发 环境 


要 使 用 Java Server Faces 进行 开发 ， 需 要 到 Sun 的 官方 网 站 下 载 其 相关 的 JAR 文件 ， 
下 载 地 址 是 http://java.sun.com/j2ee/javaserverfaces/download.html。 下 载 完成 后 ,将 下 载 的 压 
缩 包 jsE1_1 01.zip 解压 到 一 个 临时 目录 , 可 以 看 到 在 lib 目录 下 有 多 个 JAR 文件 , jsf-apijar 
和 jsf-impl.jar 是 Java Server Faces 运行 的 核心 类 库 ， 其 他 的 几 个 JAR 文件 是 它 用 到 的 组 件 ， 
同样 是 不 可 缺少 的 ， 在 编译 JSF 相关 类 时 要 把 这 些 文件 放 到 类 路 径 中 ， 在 发 布 Web 应 用 时 
应 确保 Web 应 用 可 以 找到 这 些 JAR 文件 。 


21.1.3 ”编写 相关 类 和 文件 


1. 编写 管理 Bean 
具体 管理 Bean 的 作用 会 在 下 面 介 绍 ， 简 单 而 言 就 是 它 封装 了 用 户 提交 的 信息 并 带 有 对 
这 些 信息 进行 验证 的 方法 ， 在 本 例 中 使 用 的 管理 Bean 的 源 代码 如 下 : 


package cn.ac.ict; 
import javax.faces.component.UIComponent; 
import javax.faces.component.Ullnput; 
import javax.faces.context FacesContext; 
import javax.faces.validator.LongRangeValidator; 
import javax.faces.validator. Validator; 
import javax.faces.validator.ValidatorException; 
import javax.faces.application.FacesMessage; 
public class UserRegistrationBean{ 
/下面 是 JavaBeans 的 属性 

private String firstName; 

private String lastName; 

private short age; 

private String sex; 

private String phone; 

private String email; 
// 下 面 是 与 JavaBeans 属性 对 应 的 设置 和 获取 方法 

public String getFirstName(){ 

return this .firstName; 


public String getLastName(){ 
return this.lastName; 


public short getAge(){ 
return age; 
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public String getSex(){ 
return sex; 


p 


public String getPhone(){ 
return phone; 


} 


public String getEmail(){ 
return email; 

} 

public void setFirstName(String first){ 
firstName = first; 


} 


public void setLastName(String lastX{ 
lastName = last; 


} 


public void setAge(short age}{ 
this.age = age; 


} 


public void setSex(String sex}{ 
this.sex = sex; 


} 


public void setPhone(String phone)f 
this.phone = phone; 


} 


public void setEmail(String email){ 
this.email = email; 
lL 
// 验 证 firstName 的 输入 是 否 合法 
public void validateFistName(FacesContext context, UIComponent toValidate,Object 


} 
/验证 age 的 输入 是 否 合法 ， 这 里 什么 都 不 做 
public void validateAge(FacesContext context, UIComponent toValidate,Object value}{ 


b 
/验证 Email 的 输入 是 否 合法 
public void validateEmail(FacesContext context, UIComponent toValidate,Object value) 


String email = (String) value; 
if (email.indexOf('@') == -1) { 
((UlInput)toValidate).setValid(false); 
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FacesMessage message = new FacesMessage("Invalid Email"); 
context.addMessage(toValidate.getClientld(context), message); 


b 


public String validateRegister(){ 
return "success"; 
1 
} 


可 以 看 到 ， 它 和 普通 的 JavaBeans 很 相似 ， 只 是 多 了 几 个 验证 数据 的 方法 ， 这 也 就 是 它 
与 普通 JavaBeans 的 区 别 了 。 

2. 编写 JSP 页 面 

JSF 是 MVC 模式 的 一 个 实现 ， 它 可 以 使 用 JSP 页面 作 为 视图 ， 也 可 以 不 使 用 JSP 页 面 
作为 视图 ， 使 用 起 来 还 是 很 方便 的 ， 在 本 例 中 使 用 JSP 页 面 作为 视图 ， 代 码 如 下 : 


<!DOCTYPE HTML PUBLIC "-/W3C//DTD HTML 4.01 Transitional//EN"> 
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %> 
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> 


<html> 
<head> 
<title>User Registration.jsp Form</title> 
</head> 


<body> 
<fview> 
<h2>User Register Validation </h2> 
<h:form id="userForm"> 


<h:messages id="userMessages" showDetail= "true" layout="table"/> 


<!---- 一 创建 一 个 3 列 的 表格 --> 
<h:panelGrid columns="3"> 
<!-- 一 一 可 以 认为 对 应 于 JavaBeans 的 firstName 属性 -一 一 一 -一 -一 > 
<h:outputLabel for="firstName" accesskey="F" > 
<h:outputText value="First Name"/> 
</h:outputLabel> 


<h:inputText id="firstName” 
value="#UserRegistrationBean .firstName}" 
required="true"> 
<f:validateLength minimum="2" maximum="25" /> 
</h:inputText> 


<h:message 
style="color: red; text-decoration: overline”" 
id="firstNameError" 
for="firstName"/> 
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<!-- 一 一 可 以 认为 对 应 于 JavaBeans 的 lastName 属性 -一 -一 
<h:outputLabel for="lastName" accesskey="L" 
id="lastNameLabel" 
> 
<h:outputText value="Last Name"/> 
</h:outputLabel> 


二 六 


<h:inputText id="lastName”" 
value=" 州 UserRegistrationBean.lastName}” 
required="true"> 
<f:validateLength minimum="2" maximum="25" /> 
</h:inputText> 


<h:message style="color: red; text-decoration: overline” id="lastNameError” for= 
"lastName"/> 
<1-------- 可 以 认为 对 应 于 JavaBeans 的 age 属性 ---- 
<h:outputLabel for="age" accesskey="a" id="ageLabel"> 
<h:outputText value="Age" id="text 1"/> 
</h:outputLabel> 


> 


<h:inputText id="age" value="#{UserRegistrationBean.age}"> 
<fconverter converterld="javax.faces.Short"/> 


<f:validateLongRange maximum="150" minimum="0"/> 
</h:inputText> 


<h:message style="color red; text-decoration: overline" id="ageError for="age"/> 
-可 以 认为 对 应 于 JavaBeans 的 sex 属性 -一 -一 -一 -一 > 
<h:outputLabel for="sex" accesskey="S" id="sexLabel"> 
<h:outputText value="Sex"/> 
</h:outputLabel> 


<h:inputText id="sex" value="#{UserRegistrationBean.sex}"required="true"> 
<f:validateLength minimum="2" maximum="10" /> 
</h:inputText> 


<h:message style="color: red; text-decoration: overline" id="sexError for="sex"/> 
<!—— 可 以 认为 对 应 于 JavaBeans 的 email 属性 ----------------> 
<h:outputLabel for="email" accesskey="e" id="emailLabel"> 
<h:outputText value="email"/> 
</h:outputLabel> 


<h:inputText id="email" value="#{UserRegistrationBean.email}" 
validator="#{UserRegistrationBean.validateEmail}" > 
</h:inputText> 


<h:message style="color: red; text-decoration: overline" id="emailError" for="email"/> 
<!-- 一 一 可 以 认为 对 应 于 JavaBeans 的 phone 属性 ---------------> 
<h:outputLabel for="phone" accesskey="p" id="phoneLabel"> 
<h:outputText value="Phone"/> 
</h:outputLabel> 
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<h:inputText id="phone" value="#{UserRegistrationBean.phone}" > 
</h:inputText> 


<h:message style="color: red; text-decoration: overline" id="phoneError" for="phone"/> 
</h:panelGrid> <br/> 
<h:panelGroup> 
<h:commandButton 
id="register" 
action="#{UserRegistrationBean.validateRegister}" 
value="Register" 


/> 
</h:panelGroup> 
</h:form> 
</f:view> 
</body> 
</html> 


可 以 看 到 ， 在 文件 一 开始 ， 就 声明 使 用 两 个 自 定义 的 标签 库 ， 分 别 是 JSF 的 HTML 标 
签 库 和 core 标签 库 ， 各 个 标签 与 自 定义 标签 是 同样 的 技术 ， 不 过 标签 的 使 用 方法 不 同 而 已， 
读者 如 果 要 掌握 这 些 标签 ， 可 以 查看 其 相应 的 TLD 文件 ， 了 解 各 个 标签 的 使 用 方法 ， 可 以 
看 到 这 个 文件 中 使 用 了 很 多 标签 ， 和 HTML 的 标签 有 些 相像 ， 但 又 有 不 同 ， 这 里 就 不 详细 
介绍 了 了 。 

另外 ， 在 firstName、lastName、age、sex 这 几 个 字段 上 都 对 可 输入 的 数据 的 类 型 或 长 
度 加 了 限制 ， 例 如 在 firstName 上 的 限制 代码 如 下 : 

<h:inputText id="firstName”" 
value="#{UserRegistrationBean.firstName}" 
required="true"> 
<f:validateLength minimum="2" maximum="25" /> 
</h:inputText> 
也 就 是 要 求 数据 在 2 一 25 个 字 节 之 间 。 
在 对 Email 的 输入 上 还 使 用 了 管理 Bean 中 的 验证 方法 ， 代 码 如 下 : 
<h:inputText id="email" 
value="#{UserRegistrationBean.email}" 
validator="#{UserRegistrationBean.validateEmail}" > 
</h:inputText> 

如 果 用 户 的 数据 输入 不 是 一 个 合法 的 Email 地 址 ， 就 会 提示 错误 。 

3. 编写 配置 文件 

在 使 用 JSF 开发 中 配置 文件 的 编写 也 是 比较 繁琐 的 一 件 事 ， 首 先 在 web.xml 文件 中 需 
要 配置 JSF 的 控制 器 ， 它 是 一 个 Servlet: javax.faces.webapp.FacesServlet， 在 本 应 用 中 使 用 
的 web.xml 文件 的 内 容 如 下 : 


<?xml version="1.0"?> 
<!DOCTYPE web-app PUBLIC 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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23.3 配置 Log4j 


在 应 用 程序 代码 中 加 入 日 志 请 求 是 需要 大 量 的 计划 和 精力 的 。 观 察 显示 ， 将 近 4% 的 代 
码 用 于 日 志 操作 。 因 此 ， 即 使 是 一 个 中 等 大 小 的 应 用 程序 也 会 有 上 千 行 代码 用 于 日 志 操作 。 
在 这 种 情况 下 ， 不 手动 修改 实现 对 这 些 代 码 进 行 管理 是 很 有 意义 的 。 

虽然 Log4j 环境 是 可 以 用 程序 配置 的 (例如 23.2.5 节 的 例子 一 样 ) ， 但 使 用 配置 文件 就 
更 灵活 了 。 配置 文件 可 以 被 写成 XML 文件 合适 或 者 Java Properties 格式 (key 二 value) 。 下 
面 分 别 介绍 这 两 种 方式 。 

对 Log4j 环境 的 配置 就 是 对 root logger 的 配置 ， 包 括 把 root logger 设置 为 哪个 级 别 
(Level) ; 为 它 设置 相关 联 的 Appender 等 。 这些 可 以 通过 设置 系统 属性 的 方法 来 隐 式 地 完 
成 ， 也 可 以 在 程序 中 调用 XXXConfigurator.configure() 方 法 来 显 式 地 完成 。 

Log4j 由 3 个 重要 的 组 件 构成 : 日 志 信息 的 优先 级 、 日 志 信息 的 输出 目的 地 、 日 志 信息 
的 输出 格式 。 在 配置 时 它们 也 是 主要 的 配置 元 素 。 


23.3.1 使 用 Java Properties 配置 


使 用 Java Properties 配置 就 是 按照 key 二 value 的 格式 书写 配置 属性 , 使 用 这 种 方式 是 很 
容易 理解 的 ， 而 且 也 非常 简单 。 
在 使 用 这 种 方式 进行 配置 时 ,任何 key 都 必须 以 Log4j 开头 ， 其 后 跟 相 关 的 属性 ， 下 面 
介绍 常用 的 几 种 日 志 配 置 方法 。 
. 配置 根 Logger 
en Logger 的 语法 为 : 
log4j.rootLogger = [ level ] , appenderName, appenderName, ... 


其 中 , Level 是 日 志 记录 的 优先 级 , 分 为 OFF、FATAL、 ERROR、WARN.INFO、DEBUG、 
ALL (Level 类 中 预定 义 的 ) 或 者 自己 定义 的 级 别 。Log4j 建议 只 使 用 4 个 级 别 ， 优 先 级 从 
高 到 低 分 别 是 ERROR、WARN、INFO、DEBUG。 通 过 在 这 里 定义 的 级 别 ， 可 以 控制 到 应 
用 程序 中 相应 级 别 的 日 志 信息 的 开关 。 比 如 在 这 里 定义 了 INFO 级 别 ， 则 应 用 程序 中 所 有 
DEBUG 级 别 的 日 志 信息 将 不 被 打印 出 来 。appenderName 就 是 指定 日 志 信 息 输 出 到 哪个 地 
方 ， 可 以 同时 指定 多 个 输出 目的 地 。 

2. 配置 日 志 信息 输出 目的 地 Appender 

配置 日 志 信息 输出 目的 地 Appender 的 语法 为 : 


log4j.appender.appenderName = fully.qualified.name.of.appender.class 
log4j.appender.appenderName.option1 = value1 


log4j.appender.appenderName.option = valueN 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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log4j.appender.A1.layout=org.apache.log4j.PatternLayout 
坑 障 配置 日 志 输 出 的 格式 并 
log4j.appender.A1.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%cl]-[%p] %m%n 


失 ## 设置 输出 地 A2 到 文件 (文件 大 小 到 达 指 定 尺 寸 时 产生 一 个 新 的 文件 ) 大 
log4j.appender.A2=org.apache.log4j.RollingFileAppender 

捧 # 文件 位 置 棒 

log4j.appender.A2.File=E:/study/log4j/zhuwei.html 

挫 # 文件 大 小 扒 

log4j.appender.A2.MaxFileSize=500KB 
log4j.appender.A2.MaxBackuplndex=1 

天 指定 采用 HTML 方式 输出 
log4j.appender.A2.layout=org.apache.log4j.HTMLLayout 


5. 其 他 输出 地 的 配置 

Log4j 的 输出 地 可 以 是 控制 台 、 文 件 、 回 滚 文 件 、 发 送 日 志 邮 件 、 数 据 库 日 志 表 和 自 定 
义 标 签 等 ， 不 过 不 同 的 输出 地 的 立 设置 往往 有 些 关 别 ， 下 面 举 几 个 例 上 | 子 ， 分 别 实现 输出 到 发 
送 日 志 邮 件 、 输 出 到 数据 库 日 志 表 、 自 定义 标签 ， 读 者 可 以 通过 这 些 例子 了 解 不 同 的 输出 
地 的 配置 流程 。 


# 发 送 日 志 邮 件 


检 检 并 检 才 术 并 检 村 村 并 村 并 并 天 桩 并 村 并 村 并 旭 检 
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender 
log4j.appender.MAIL.Threshold=FATAL 

# 设 置 缓存 大 小 

log4j.appender.MAIL.BufferSize=10 

# 设 置 邮件 的 发 送 者 
log4j.appender.MAIL.From=chenyl@hollycrm.com 

# 设 置 邮件 的 接收 者 
log4j.appender.MAIL.SMTPHost=mail.hollycrm.com 

# 设 置 邮件 主题 

log4j.appender.MAIL.Subject=Log4J Message 

# 设 置 邮件 的 接收 者 
log4j.appender.MAIL.To=chenyl@hollycrm.com 

# 设 置 输出 格式 
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout 
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - 
%m%n 


# 输出 到 数据 库 日 志 


HHHHHH HH 
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender 
# 数 据 库 的 URL， 这 里 为 localhost 上 的 test 数据 库 
log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test 
# 数 据 库 驱 动 程序 
log4j.appender.DATABASE.driver=com.mysqljdbc.Driver 

# 数 据 库 用 户 名 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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"info"、"warn"、"error"、"fatal" 和 "off'。 当 值 为 "off' 时 表示 没有 任何 日 志 信 息 被 输出 。 

口 param [ 子 元 素 ， 可 有 任意 个 ]: 创建 level 对 象 时 传递 给 类 构造 方法 的 参数 。 

8. appender-ref 元 素 

appender-ref 元 素 引 用 一 个 appender 元 素 的 名 字 ， 为 logger 对 象 增加 一 个 appender。 

口 ref [必须 设置 的 属性 ]: 一 个 appender 元 素 的 名 字 的 引用 。 

口 appender-ref 元 素 没 有 子 元 素 。 

9. param 元 素 

param 元 素 在 创建 对 象 时 为 类 的 构造 方法 提供 参数 。 它 可 以 成 为 appender layout、 filter、 
errorHandler、level、categoryFactory 和 root 等 元 素 的 子 元 素 。 

口 name and value [#REQUIRED attributes]: 提供 参数 的 一 组 名 值 对 。 

口 param 元 素 没 有 子 元 素 。 

10. 元 素 创建 实例 

(1) 创建 FileAppender 对 象 。 可 以 为 FileAppender 类 的 构造 方法 传递 两 个 参数 : File 

表示 日 志文 件 名 ; Append 表示 如 文件 已 存在 , 是 否 把 日 志 追 加 到 文件 尾部 , 可 能 取 值 为 "true" 
和 "false" (默认 ) 。 


<appender name="file.log" class="org.apache.log4j.FileAppender"> 
<param name="File" value="/tmp/log.txt" /> 

<param name="Append" value="false" /> 

<layout ...> 


</layout> 
</appender> 
(2) 创建 RollingFileAppender 对 象 。 除 了 File 和 Append 以 外 ， 还 可 以 为 

RollingFileAppender 类 的 构造 方法 传递 两 个 参数 : MaxBackupIndex 表示 备份 日 志文 件 的 个 
数 〈 默 认 是 1 个 ) ，MaxFileSize 表示 日 志文 件 允 许 的 最 大 字 节 数 〈 默 认 是 10MB) 。 

<appender name="rollingFile.log" class="org.apache.log4j.RollingFileAppender"> 

<param name="File" value="/tmp/rollingLog.txt" /> 

<param name="Append" value="false" /> 

<param name="MaxBackuplndex" value="2" /> 

<param name="MaxFileSize" value="1024" /> 

<layout ... > 

</layout> 

</appender> 


(3) 创建 PatternLayout 对 象 。 可 以 为 PatternLayout 类 的 构造 方法 传递 参数 Conversion 
Pattern。 


<layout class="org.apache.log4j.PatternLayout> 
<param name="Conversion" value="%d [%t] %p - %m%n" /> 
</layout> 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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<logger name="shop.log"> 
<!-- 设置 域名 限制 ， 即 shop.log 域 及 以 下 的 日 志 均 输出 到 下 面 对 应 的 通道 中 --> 
<level value="debug" /> 


<!-- 设置 级 别 --> 
<appender-ref ref="cn.ac.ict.shop" /><!-- 与 前 面 的 通道 id 相对 应 --> 
</logger> 


<root> <!-- 设置 接收 所 有 输出 的 通道 --> 
<appender-ref ref="cn.ac.ict.all" /><!-- 与 前 面 的 通道 id 相对 应 --> 
</root> 


</log4j:configuration> 
23.3.3 Log4j 配置 实现 过 程 


对 Log4j 环境 的 配置 就 是 对 root logger 的 配置 ， 包 括 将 root logger 设置 为 哪个 级 别 
(level) ; 为 它 增加 哪些 appender 等 ， 这 些 可 以 通过 设置 系统 属性 的 方法 来 隐 式 地 完成 ， 
也 可 以 在 程序 中 调用 XXXConfigurator.configure() 方 法 来 显 式 地 完成 ， 所 有 其 他 的 logger 都 

是 root logger 的 后 代 ， 所 以 它们 〈 默 认 情况 下 ) 都 将 继承 root logger 的 性 质 。 
下 面 讲述 默认 的 log4j 初始 化 过 程 。 
Logger 类 的 静态 初始 化 块 (static initialization block ) 中 对 Log4j 的 环境 做 默认 的 初始 化 。 


从 注意 : 如 果 程序 员 已 经 通过 设置 系统 属性 的 方法 来 配置 了 Log4j 环境 ， 则 不 需要 再 显 式 
地 调用 XXXConfigurator.configure() 方 法 来 配置 Log4j 环境 了 。 
Logger 的 静态 初始 化 块 在 完成 初始 化 过 程 时 将 检查 一 系列 Log4j 定义 的 系统 属性 。 它 
所 做 的 事情 如 下 : 

口 检查 系统 属性 log4j.defaultInitOverride， 如 果 该 属性 被 设置 为 false， 则 执行 初始 化 ; 
否则 (只 要 不 是 false， 无 论 是 什么 值 ， 甚 至 没有 值 ， 都 是 否则 ) ， 跳 过 初始 化 。 

口 把 系统 属性 log4j.configuration 的 值 赋 给 变量 resource。 如 果 该 系统 变量 没有 被 定义 ， 
则 把 resource 赋值 为 "log4j.properties"。 

口 试图 把 resource 变量 转化 成 为 一 个 URL 对 象 url。 如 果 一 般 的 转化 方法 行 不 通 ， 就 
调用 org.apache.log4j.helpers.Loader.getResource(resource，Logger.class) 方 法 来 完成 
转化 。 

口 如 果 url 以 "html" 或 "xml" 结 尾 ， 则 调用 方法 DOMConfigurator.configure(url) 来 完成 
初始 化 ;和 否则 调用 方法 PropertyConfigurator.configure(url) 来 完成 初始 化 。 如 果 url 
指定 的 资源 不 能 被 获得 ， 则 跳出 初始 化 过 程 。 

全 注意 : 在 Apache 的 Log4j 文档 中 建议 使 用 定义 log4j.configuration 系统 属性 的 方法 来 设置 
默认 的 初始 化 文件 是 一 个 好 方法 。 

所 以 ， 对 于 使 用 Java Properties 配置 文件 ， 要 使 用 PropertyConfigurator.configure(url) 来 完成 

初始 化 ， 而 对 于 使 用 xml 的 配置 文件 需要 使 用 DOMConfigurator.configure(url) 来 完成 初始 化 。 


“434。 JSP 网 络 开发 技术 及 整合 应 用 


23.4 Web 应 用 中 使 用 Log4j 的 例子 


在 本 书 “JSP 与 Java Mail Web 应 用 ”一 章 中 介绍 的 实例 中 就 是 使 用 Log4j 进行 日 志 记 
录 的 ， 下 面 介 绍 其 使 用 的 配置 文件 : 


#ConfigLog_In.properties 

# 设 置 logger 和 level 

log4j.rootCategory=DEBUG, R 

# 输 出 到 文件 
log4j.appender.R=org.apache.log4j.FileAppender 

# 输 出 的 日 志文 件 名 在 项 目的 根 目录 中 存放 ) 
log4j.appender.R.File=D:\\Tomcat 5.0\logs\JMailLog4j.txt 
# 文 件 格式 为 自 定义 模式 (共有 4 种 可 选 ) 
log4j.appender.R.layout=org.apache.log4j.PatternLayout 
log4j.appender.R.layout.ConversionPattern=%m%n 


编写 好 配置 文件 后 ， 还 需要 在 程序 中 配置 一 下 ， 让 程序 知道 配置 文件 的 位 置 ， 并 创建 
合适 的 日 志 进 行 记录 。 配 置 Log4j 的 代码 (Log4jjava) 如 下 : 


package cn.ac.ict.JavaMail; 
import java.net.URL; 


import org.apache.log4j.Logger; 
import org.apache.log4j.PropertyConfigurator; 


public class Log4j { 
public static Logger 
logger = Logger.getLogger(cn.ac.ictJavaMail.Log4j.class.getName()); 


// 调 用 配置 文件 
public static void ConfigLog() { 
String resource = "ConfigLog.properties"; 
URL configFileResource = 
cn.ac.ict.JavaMail.Log4j.class.getResource(resource); 
PropertyConfigurator.configure(configFileResource); 


} 

// 调 用 配置 文件 二 日 志 换 行 输出 ) 

public static void ConfigLog_In() { 
String resource = "ConfigLog_In.properties"; 
URL configFileResource = 

cn.ac.ict.JavaMail.Log4j.class.getResource(resource); 

PropertyConfigurator.configure(configFileResource); 

} 

} 


在 这 个 类 中 使 用 的 方法 都 是 static 的 ， 可 以 直接 调用 来 配置 Log4j， 配 置 好 后 ， 就 可 以 
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在 程序 中 使 用 了 。 
例如 ， 在 MailUserInfoBean 类 的 构造 函数 中 调用 了 ConfigLog_ln0 对 其 进行 配置 : 


public MailUserlnfoBean(){ 
Log4j.ConfigLog In(); 


} 
在 程序 中 就 可 以 这 样 使 用 Log4j 进行 日 志 的 记录 了 : 
catch (NoSuchProviderException e) { 
e.printStackTrace(); 
Log4j.logger.debug("Get a Store error!"); 
Log4j.logger.debug(e); 
return JMailUtil.FAILED; 

}catch (MessagingException e) { 
Log4j.logger.debug("Get a Store error!"); 
e.printStackTrace(); 
Log4j.logger.debug(e); 
return JMailUtil.FAILED; 

} 

程序 运行 后 ， 日 志 的 内 容 大 致 如 下 : 
The Store is connected! 
邮件 被 成 功 删除 ! 
邮件 被 成 功 删除 ! 
邮件 被 成 功 删除 ! 
发 送 邮件 失败 !javax.mail.SendFailedException: No recipient addresses 
发 送 邮件 成 功 ! 
发 送 邮件 成 功 ! 


2 和 :小 结 


Log4j 是 一 个 优秀 的 日 志 记录 工具 ， 通 过 使 用 Log4j 可 以 很 方便 地 进行 程序 的 调试 以 及 
程序 流程 的 跟踪 和 分 析 。 

在 本 章 中 首先 介绍 了 一 个 在 JSP 文件 中 使 用 日 志 的 例子 ， 然 后 介绍 了 很 多 相关 的 基础 
知识 ， 第 一 个 例子 是 在 程序 中 配置 Log4j 的 ， 这 样 做 很 不 方便 ， 因 此 在 后 面 一 个 Java Mail 
的 应 用 中 将 其 改 为 使 用 配置 文件 的 方式 ， 大 大 简化 了 日 志 的 记录 ， 读 者 可 以 尝试 使 用 这 种 
方式 进行 日 志 记 录 操 作 。 


第 24 章 使 用 XDoclet 简化 JSP 的 
Web 开发 


XDoclet 是 一 个 用 于 简化 配置 文件 书写 的 开源 工具 , 使 用 它 可 以 大 大 减少 开发 Java 程序 
所 需要 书写 配置 文件 的 时 间 。 在 本 章 中 介绍 如 何 使 用 XDoclet 简化 JSP 的 Web 开发 。 


24.1 快速 体验 XDoclet 使 用 XDoclet 的 简单 例子 


24.1.1 XDoclet 介绍 


从 本 书 前 面 的 介绍 可 以 看 到 ， 使 用 JSP 技术 进行 开发 ， 需 要 很 多 的 配置 工作 ， 往 往 要 
发 布 一 个 组 件 需要 写 几 个 XML 文件 , 而 任何 一 个 文件 的 某 个 地 方 出 了 错误 都 会 造成 配置 失 
败 ， 调 试 起 来 也 非常 麻烦 ， 为 了 解决 这 个 难题 ， 本 章 介绍 一 个 非常 好 用 的 用 于 生成 配置 文 
件 的 开源 工具 XDoclet。 

XDoclet 是 一 个 通用 的 代码 生成 实用 程序 ， 是 一 个 扩展 的 Javadoc Doclet 引擎 〈 现 已 与 
Javadoc Doclet 独立 ) ，XDoclet 是 EJBDoclet 的 后 继 者 ， 而 EJBDoclet 是 由 Rickard Oberg 
发 起 的 〈XDoclet 的 官方 主页 : http://xdoclet.sourceforge.net/xdoclet/index.html)》 。 

XDoclet 因为 可 以 自动 生成 EJB 复杂 的 接口 和 部 署 描 述 文件 而 使 得 很 多 人 知道 它 , 但 现 
在 的 XDoclet 已 经 发 展 成 了 一 个 全 功能 的 、 面 向 属性 的 代码 生成 框架 。J2EE 代码 生成 只 是 
XDoclet 的 一 个 应 用 方面 ， 它 可 以 完成 的 任务 已 经 远 远 超越 了 J2EE 和 项 目 文档 的 生成 。 

在 下 面 会 介绍 一 个 使 用 XDoclet 的 简单 例子 ， 使 用 XDoclet 为 Servlet 生成 配置 信息 。 


24.1.2 ”安装 配置 XDoclet 

XDoclet 是 开源 的 免费 软件 ， 可 以 从 其 官方 主页 上 免费 下 载 〈 目 前 最 新 版 本 为 1.2.3， 
xdoclet-bin-1.2.3.zip) ， 将 下 载 的 压缩 文件 解压 到 某 个 目录 ， 并 把 这 个 目录 称 为 XDOCLET 
HOME， 在 使 用 XDoclet 时 一 般 要 结合 ANT 使 用 ， 可 以 在 build 文件 中 设置 使 用 的 
XDOCLET HOME， 所 以 这 里 不 多 作 介绍 。 
24.1.3 Java 源 程 序 和 添加 注释 


下 面 编 号 一 个 简单 的 用 户 登录 页 面 ， 这 个 Servlet 可 以 根据 配置 信息 验证 用 户 的 身份 ， 
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除了 像 开发 其 他 Java 程序 要 写 的 代码 和 注释 外 ， 还 需要 添加 XDoclet 需要 的 额外 注释 ， 
XDoclet 就 是 根据 这 些 注释 (以 @tags 的 格式 出 现 ) 来 生成 配置 文件 的 。 下 面 是 Java 源 程序 : 


package cn.ac.ict.XDoclet; 


import java.io.IOException; 

import javax.servlet.ServletConfig; 

import javax.servlet.ServletException; 

import javax.servlet.http.HttpServlet; 

import javax.servlet.http.HttpServletRequest'; 
import javax.servlet.http.HttpServletResponse; 


/or 
* @web.servlet name="LoginServlet" display-name="Login Servlet XDoclet Sample" 
\f load-on-startup="1" 

* @web.servlet-init-param name="username" 
value="${servlet.username}" 
* @web.servlet-init-param name="password" 
value="${servlet.password}" 


* @web.servlet-mapping url-pattern="/Login/*" 
3 
public class XDocletLoginSample extends HttpServlet { 


private String username; 
private String password; 


public void init(ServletConfig config) throws ServletException { 
// 从 web.xml 中 获得 初始 化 参数 
super.init(config); 
this.username = config.getInitParameter("username"); 
this.password = config.getlnitParameter("password"); 


protected void doGet(HttpServletRequest request, 
HttpServletResponse response) throws ServletException, IOException { 
doPost(request, response); 


protected void doPost(HttpServletRequest request, 
HttpServletResponse response) throws ServletException, IOException { 
// 首 先 设置 文档 类 型 
response.setContentType("text/html; charset=GBK"); 
// 获 取 输 出 流 


java.io.PrintWriter out = response.getWriter(); 


out.write("<!IDOCTYPE HTML PUBLIC \-/W3CWDTD HTML 4.01 Transitional//EN\" 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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out.write( "rn ); 
out.write("” <tr>\r\in"); 
out.write(" ”<td align=\"centen"><span class=\"style3\"> 用 户 名 或 者 密码 错误 !</span></td>\An"); 
out.write(” </tr>\n\n"); 
out.write(” "); 
} 
if(!lloginX{ 
out.write("\rn"); 
out.write(” <tr>\r\in"); 
out.write(" <td align=\Vcenten"> 用 户 名 : <input name=\"username\" type=\"textV></td>\nn"); 
out.write(” </tr>\An"); 
out.write(” <tr>\r\n"); 
out.write(" <td align=\"center\"> 密 &nbsp; 码 : \An"); 
out.write(" <input name=\"password\" type=\"text\"></td>\r\n"); 
out.write(” </tr>\An"); 
out.write(” <tr>\r\in"); 
out.write(" <td align=\centen"><input name=\"submitW type=\"submit value=\" 提 交 
\">&nbsp;<input name=\"reset\" type=\"reset\" value=\" 重 置 *></td>\nAn"); 
out.write(” </tr>\An"); 
out.write(” "); 
Jelse{ 
out.write("\A\n"); 
out.write(” <tr>\nAn"); 
out.write(” <td align=\"center"><span class=\"style3\"> 您 已 成 功 登录 ! </span></td>\r\n"); 
out.write(” </tr>\An"); 
out.write(" \r\n"); 
out.write(” "); 
y 
out.write("\rn' ); 
out.write("</table>\r\n"); 
out.write("</form>\A\n"); 
out.write("\n\n"); 
out.write("</body>\A\n"); 
out.write("</html>\An"); 


} 


24.1.4 书写 build.xml 文件 


本 例 是 将 XDoclet 和 Ant 配合 使 用 的 , 下 面 是 编译 和 部 署 这 个 简单 应 用 时 Ant 所 需要 的 
build.xml 文件 : 


<?xml version="1.0" encoding="GBK"?> 


*。440。 JSP 网 络 开发 技术 及 整合 应 用 


<project name="filtering" default="deploy" basedir="."> 
<description> 一 个 简单 的 XDoclet 实例 </description> 


<!-- 载 入 属性 文件 --> 
<property file="build.properties"/> 


<!-- 定义 类 路 径 --> 
<path id="web.classpath"> 
<pathelement location="${tomcat.home}commonl/lib/servlet-api.jar"/> 
<pathelement location="${tomcat.homeWcommon/lib/jsp-api.jar"/> 
</path> 
<path id="xdoclet.classpath"> 
<fileset dir="${xdoclet.home}lib"> 
<include name="™.jar"/> 
</fileset> 
<path refid="web.classpath"/> 
</path> 


<!-- 初始 化 ,建立 目录 --> 
<target name="init"> 

<mkdir dir="${dist.dir}"/> 

<mkdir dir="${dist.dir}WEB-INF"/> 

<mkdir dir="${dist.dirHWEB-INF/classes"/> 
</target> 


<!-- XDoclet 的 WebDoclet 任务 --> 
<target name="webdoclet" depends="init"> 
<taskdef 
name="webdoclet" 
classpathref="xdoclet.classpath” 
classname="xdoclet.modules.web.WebDocletTask"/> 


<webdoclet destDir="${dist.dir}/WEB-INF" force="${xdoclet.force}"> 
<deploymentdescriptor Servletspec="2.4" xmlencoding="GBK"/> 
<fileset dir="${src.dir}" includes="™**/*.java"/> 
</webdoclet> 
</target> 


<!-- 编译 与 部 署 -> 
<target name="deploy" depends="webdoclet"> 

<javac srcdir="${src.dir}" destdir="${dist.dir}/WEB-INF/classes"> 

<classpath refid="web.classpath"/> 

</javac> 

<jar destfile="${tomcat.home}/webapps/${app.name}.war" basedir="S${dist.dir}"/> 
</target> 

</project> 
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其 中 最 主要 的 就 是 使 用 了 XDoclet 的 WebDoclet 任务 ， 它 是 XDoclet 预定 义 好 的 ， 在 
使 用 时 需要 使 用 <taskde 他 元 素 引 入 这 个 务 ， 它 的 实现 类 是 xdocletmodules.web. 
WebDocletTask。 在 上 面 的 build 文件 中 包含 了 一 个 属性 配置 文件 build.properties， 它 的 内 容 
要 根据 Tomcat 和 XDoclet 安装 的 情况 进行 修 四 大 致 内 容 如 下 : 

#1 环境 设置 HH 并 


# Tomcat 安装 主 目录 
tomcat.home=D:/Tomcat 5.0 

# ”xdoclet 安装 目录 
xdoclet.home=E:/xdoclet-1.2.3 
# ”web 的 临时 目录 
dist.dir=./dist 

# ” 源 文 件 目 录 

src.dir=./src 

# 发布 的 程序 名 
app.name=XDocletLogin 

# Servlet 参数 ， 可 以 改变 
servlet.username=XDocletUser 
Servlet.password=XDocletPass 


在 上 面 的 文件 中 设置 了 合法 的 用 户 名 和 密码 ,可 以 作为 Servlet 的 初始 化 参数 ,在 Servlet 
的 注释 中 己 有 体现 。 


24.1.5 ”运行 实例 


按照 上 面 的 安排 准备 好 所 有 的 文件 后 ， 这 个 应 用 的 目录 结构 如 图 24.1 所 示 。 这 时 在 这 
个 目录 下 运行 Ant 命令 ,效果 如 图 24.2 所 示 。 


EE YDoclet 


国 DocletLoginSanple. java 
index. jsp 
"login jsp 
加 build properties 
器] build xml 


图 24.1 XDoclet 应 用 目录 结构 图 24.2 运行 Ant 命令 


启动 Tomcat， 然 后 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/XDocletLogin 
/Login, 任意 输入 用 户 名 和 密 密码 后 ， 可 能 的 效果 图 如 图 24.3 所 示 。 

输入 正确 的 用 户 名 和 密码 : 用 户 名 是 XDocletUser， 密 码 是 XDocletPass， 可 以 看 到 页 
面 效 果 如 图 24.4 所 示 。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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<servlet> 
<display-name>Login Servlet XDoclet Sample</display-name> 
<servlet-name>LoginServlet</servlet-name> 
<servlet-class>cn.ac.ict.XDoclet.XDocletLoginSample</servlet-class> 


<init-param> 
<param-name>username</param-name> 
<param-value>XDocletUser</param-value> 

</init-param> 

<init-param> 
<param-name>password</param-name> 
<param-value>XDocletPass</param-value> 

</init-param> 


<load-on-startup>1</load-on-startup> 
</servlet> 


<l-— 

To use non XDoclet servlets, create a servlets.xml file that 
contains the additional servlets (eg Struts) and place it in your 
project's merge dir， Don't include servlet-mappings in this file, 
include them in a file called servlet-mappings.xml and put that in 
the same directory. 

=-> 


<Servlet-mapping> 
<servlet-name>LoginServlet</servlet-name> 
<url-pattern>/Login/*</url-pattern> 
</servlet-mapping> 


二 

To specify mime mappings, create a file named mime-mappings.xml, put it in your project's 
mergedir. 

Organize mime-mappings.xml following this DTD slice: 


<!ELEMENT mime-mapping (extension, mime-type)> 
--> 


过 区 
To specify error pages, create a file named error-pages.xml, put it in your project's mergedir. 
Organize error-pages.xml following this DTD slice: 


<!ELEMENT error-page ((error-code | exception-type), location)> 
--> 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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属性 的 最 后 一 行 。 
下 面 来 看 看 Servlet 文件 中 的 注释 都 起 了 什么 作用 ， 在 Servlet 文件 中 有 如 下 注释 : 


/ce 
* @web.servlet name="LoginServlet" display-name="Login Servlet XDoclet Sample" 
区 load-on-startup="1" 

* @web.servlet-init-param name="username" 
value="${servlet.username}" 
* @web.servlet-init-param name="password" 
value="${servlet.password}y" 
* @web.servlet-mapping url-pattern="/Login/*" 

| 


首先 @web.servlet name 标签 指定 了 这 个 Servlet 在 web.xml 中 配置 时 使 用 的 名 字 
(<servlet-name> 元 素 的 值 ) ，display-name 用 于 生成 <display-name> 元 素 ，load-on-startup 
用 于 生成 <load-on-startup> 元 素 ， 也 就 是 说 通过 第 一 个 标签 生成 了 如 下 的 配置 信息 : 


<display-name>Login Servlet XDoclet Sample</display-name> 
<servlet-name>LoginServlet</servlet-name> 
<servlet-class>cn.ac.ict.XDoclet.XDocletLoginSample</servlet-class> 
<load-on-startup>1</load-on-startup> 


然后 是 @web.servlet-init-param 标签 ， 它 指定 了 Servlet 的 初始 化 参数 ， 用 于 生成 
<init-param> 元 素 ， 其 中 name 属性 生成 子 元 素 <param-name>、value 属性 生成 子 元 素 
<param-value>。 也 就 是 说 ， 这 个 标签 最 终生 成 的 配置 信息 是 : 


<init-param> 
<param-name>username</param-name> 
<param-value>XDocletUser</param-value> 
</init-param> 
<init-param> 
<param-name>password</param-name> 
<param-value>XDocletPass</param-value> 
</init-param> 
最 后 是 @web.servlet-mapping 标签 ， 它 指定 了 这 个 Servlet 的 映射 信息 ，url-pattern 指定 
了 映射 到 这 个 Servlet 的 URL， 这 个 标签 生成 了 如 下 的 配置 信息 : 
<servlet-mapping> 
<servlet-name>LoginServlet</servlet-name> 
<url-pattern>/Login/*</url-pattern> 
</servlet-mapping> 


其 中 <servlet-name> 元 素 由 @web.servlet name 标签 指定 。 
这 些 就 是 配置 文件 的 形成 来 源 ，XDoclet 能 够 生成 配置 文件 就 是 根据 这 些 注释 来 实现 
的 ， 如 果 注 释 写 得 不 正确 或 者 不 规范 就 无 法 生成 想 要 的 信息 。 
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24.3 使 用 XDoclet 进行 Web 开发 


使 用 XDoclet 可 以 为 开发 EJB、Servlet、Filter 等 提供 很 大 的 方便 ， 使 用 XDoclet 进行 
Web 开发 更 是 可 以 省 去 很 多 工作 ， 而 且 根 据 上 面 的 介绍 ， 读 者 也 可 以 了 解 到 使 用 XDoclet 
关键 要 用 合适 的 标签 写 好 注释 ， 下 面 就 结合 XDoclet 为 Web 开发 提供 的 标签 介绍 如 何 使 用 
XDoclet 加 速 Web 开发 的 进程 。 


24.3.1 开发 Struts 


(1) @struts 标签 用 于 为 开发 Struts 提供 支持 ， 其 中 它 的 类 级 别 的 标签 如 表 24.1 所 示 。 
表 24.1 @struts 的 类 级 别 的 标签 


标 签 描述 
Qstruts.action 用 于 定义 Action 类 和 它 的 属性 
Qstruts.action-exception 定义 Action 类 的 异常 处 理 器 
Qstruts.action-forward 为 Action 类 定义 局 部 转发 
Qstruts.action-Setpropert 为 Action 类 创建 set-propert 
Qstruts.dynaform 定义 一 个 动态 的 Form Bean 和 它 的 属性 
Qstruts.form 定义 一 个 Form Bean 和 它 的 属性 


(2) @struts.action 用 于 定义 Action 类 和 它 的 属性 ， 它 的 参数 及 其 描述 如 表 24.2 所 示 。 
表 24.2 @struts.action 标 签 的 参数 及 其 描述 


name text Action 的 名 字 ， 在 这 个 Struts 应 用 中 是 惟一 的 
e text 为 这 个 Action 实例 化 的 类， 默认 就 是 当前 类 耕 
className text 用 于 为 这 个 Action 提 供 服务 的 ActionMapping 的 子 类 的 全 名 否 
_path text 这 个 Action 符 号 的 路 径 是 
scope text 定义 Action 的 范围 ， 为 request、session、application 的 一 种 是 
input text 为 这 个 Action 提 供 输入 的 路 径 是 
roles text 允许 访问 这 个 ActionMapping 对 象 的 安全 角色 名 ， 用 逗号 分 隔 否 
validate text 这 个 Action 的 验证 标志 ， 默 认为 true 是 
arameter text 这 个 Action 的 可 选 参数 是 


例如 下 面 的 一 段 注释 : 


@struts.action 
path="/struts/foo" 


将 会 生成 如 下 的 配置 信息 


<action 
path="/struts/foo" 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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validate= "true"” 
> 
<forward 
name="success" 
path="/struts/getAll.do" 
redirect="false" 
> 
</action> 


人 注意: 如 何 使 用 上 面 的 例子 将 在 本 章 最 后 一 小 节 介绍 。 
24.3.2 ”开发 Servlet 过 滤器 


(1) @web.filter 标签 用 于 定义 Servlet 过 滤器 ， 它 只 能 对 Servlet 加 注释 。 它 的 参数 及 
其 描述 如 表 24.6 所 示 。 


表 24.6 @web.fiter 标 签 的 参数 及 其 描述 


description 描述 信息 
(2) @web.filter-init-param 用 于 为 过 滤器 指定 初始 化 参数 , 它 的 参数 及 其 描述 如 表 24.7 
所 示 。 
表 24.7 @web .filter-init-param 标 签 的 参数 及 其 描述 


name 参数 的 名 字 
value 参数 的 值 
description 描述 信息 
(3) @web.filter-mapping 标签 用 于 为 过 滤器 定义 映射 信息 ， 它 的 参数 及 其 描述 如 表 24.8 
所 示 。 


表 24.8”@web.filter-mapping 标 签 的 参数 及 其 描述 


参数 描 述 
url-pattern 过 滤器 符合 的 URL 
servlet-name 过 滤器 Servlet 的 名 字 区 


dispatcher 与 这 个 过 滤器 有 关 的 请 求 转发 器 


例如 下 面 的 一 个 过 滤器 的 例子 用 到 了 关于 过 滤器 定义 的 标签 ， 下 面 是 TimerFilter.java 
的 源 代码 : 


package cn.ac.ict; 
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import javax.servlet.*; 
import javax.servlet.http.HttpServletRequest'; 
import java.io.IOException; 
/* @web filter 

人 display-name="Timer Filter" 
name="TimerFilter" 


x 
* 
* @web .filter-init-param 
name="param1" 
- value="value1" 


* 


* @web .filter-init-param 


号 name="param2” 
value="value2" 

* @web.filter-mapping 

. url-pattern="*.xmI" 
| 


public class TimerFilter implements Filter { 
private FilterConfig config = null; 


public void init(FilterConfig config) throws ServletException { 
this.config = config; 


} 


public void destroy() { 
config = null; 


} 


public void doFilter(ServletRequest request, ServletResponse response, 
FilterChain chain) throws IOException, 
ServletException { 
long before = System.currentTimeMillis(); 


chain.doFilter(request, response); 

long after = System.currentTimeMillis(); 
String name = ""; 

if (request instanceof HttpServletRequest) 


name = ((HttpServletRequest) request).getRequestURI(); 


config.getServletContext().log(name + ": " + (after - before) + "ms"); 


b 
这 个 文件 被 XDoclet 解析 后 会 为 这 个 Filter 生成 如 下 的 配置 信息 : 


<filter> 
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<filter-name>TimerFilter</filter-name> 
<display-name>Timer Filter</display-name> 
<filter-class> cn.ac.ict.TimerFilter</filter-class> 


<init-param> 


<param-name>param1</param-name> 
<param-value>value1</param-value> 


</init-param> 
<init-param> 


<param-name>param2</param-name> 
<param-value>value2</param-value> 


</init-param> 


</filter> 


<filter-mapping> 


<filter-name>TimerFilter</filter-name> 
<url-pattern>*.xml</url-pattern> 


</filter-mapping> 


全 注意 : 如何 使 用 上 面 的 例子 将 在 本 章 最 后 一 小 节 介绍 。 


24.3.3 ”开发 自 定义 标签 


@jsp.tag 标签 用 于 多 


全 自 定 义 标 签 加 注释 ， 它 的 参数 及 其 描述 如 表 24.9 所 示 。 
表 24.9 @jsp.tag 标 签 的 参数 及 其 描述 


参 数 
name text JSP 标 签 的 名 字 
tei-class text | JSP 的 tei 类 名 
body-content text 1 和 人 内 容 : tagdependent、JSP 或 empty， 其 默认 值 是 JSP 


display-name text 


签 的 显示 名 称 


small-icon text 


二 小 图 标 


large-icon text 


标签 的 大 图 标 


description text 


24.3.4 ”运行 例子 


标签 的 描述 信息 


在 24.3.1 节 和 24.3.2 节 中 介绍 了 两 个 例子 ， 下 面 介 绍 如 何 演示 这 两 个 例子 ， 首 先 要 编 
写 一 个 build.xml 文件 ， 其 内 容 如 下 : 


<?xml version="1.0" encoding="ISO-8859-1"?> 


<project name="XDoclet Examples" default="compile" basedir="."> 
<property file="build-dist.properties"/> 
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<path id="samples.class.path"> 
<fileset dir="${lib.dir}"> 
<include name="*.jar"/> 
</fileset> 
<fileset dir="${samples.lib.dir}"> 
<include name="*.jar"/> 
</fileset> 
<fileset dir="${dist.lib.dir}"> 
<include name="*.jar"/> 
</fileset> 
</path> 


<target name="init"> 
<tstamp> 
<format property="TODAY" pattern="d-MM-yy"/> 
</tstamp> 


<taskdef 
name="webdoclet" 
classname="xdoclet.modules.web.WebDocletTask" 
classpathref="samples.class.path" 
/> 
</target> 
<!-- ”建立 临时 目录 --> 
<target name="prepare" depends="init"> 
<mkdir dir="${samples.classes.dir}"/> 
<mkdir dir="${samples.gen-src.dir}"/> 
<mkdir dir="${samples.meta-inf.dir}"/> 
</target> 
<!-- ”webdoclet 目标 --> 
<target name="webdoclet" depends="prepare" 
description="Generate deployment descriptors (run actionform to generate forms first)"> 


<webdoclet 

destdir="${samples.gen-src.dir}" 

mergedir="parent-fake-to-debug” 

excludedtags="@version,@author@todo" 

addedtags="@xdoclet-generated at ${TODAY},@copyright The XDoclet Team, @author 

XDoclet,@version ${version}y" 

force="${samples.xdoclet.force}" 

verbose="false”" 

2 

<fileset dir="${samples.java.dir}"> 
<include name="™*/*Servlet.java"/> 
<include name="™*/*Filter.java"/> 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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这 个 文件 中 的 关键 部 分 就 是 WebDoclet 目标 。 

在 初始 化 目标 中 定义 了 名 为 WebDoclet 的 任务 ， 在 WebDoclet 目标 调用 了 这 个 任务 ， 
并 使 用 了 两 个 标签 <strutsconfigxml> 和 <deploymentdescriptor>， 分 别 用 于 生成 web.xml 文件 
和 struts-config.xml 文件 ， 还 调用 了 <strutsvalidationxml> 来 生成 Struts 的 验证 信息 。 

在 本 代码 开头 包含 了 一 个 文件 ， 这 个 文件 中 声明 了 很 多 需要 用 到 的 属性 ， 其 代码 如 下 : 

xdoclet.root.dir=E:/xdoclet-1.2.3 


lib.dir = ${xdoclet.root.diry/lib 
dist.lib.dir = ${lib.dir} 


samples.dir =. 

samples.dist.dir = ${samples.dirytarget 
samples.lib.dir = ${samples.dirMlib 
samples.src.dir = ${samples.dir}y/src 
samples.java.dir = ${samples.src.dir}yjava 
samples.gen-src.dir = ${samples.dist.dir}/gen-src 


samples.meta-inf.dir = ${samples.dist.dir}/meta-inf 局 tomah 四 用 
samples.web-inf.dir = ${samples.dist.dir}/web-inf a i 
samples.merge.dir = ${samples.src.dir/merge es 
samples.classes.dir = ${samples.dist.dir}/classes velocity- dep-1. 4. jar 


webwork-2. 1.7, jar 
samples.web.dir = ${samples.src.dir}/web 


samples.xdoclet.force = false 


读者 在 运行 这 个 程序 时 需要 把 XDoclet 的 根 路 径 修 A ie 

改 一 下 。 各 个 文件 都 改写 完成 后 ， 其 整个 文件 夹 的 结构 本 

如 图 24.5 所 示 。 Sn i 
在 该 目录 下 运行 Ant 命令 可 以 看 到 各 种 信息 ， 运 行 明 warasememe 

结束 后 可 以 在 其 生成 的 子 目录 target 下 查找 相应 的 配置 图 24.5 程序 结构 

文件 。 


24.4 小 结 


XDoclet 是 一 个 优秀 的 通用 的 代码 生成 实用 程序 ， 使 用 它 简化 了 很 多 Web 应 用 的 开发 。 
在 本 章 中 只 是 介绍 了 它 的 一 小 部 分 应 用 ， 它 还 可 以 结合 Hibernate 等 工具 开发 。 通 过 前 面 的 
介绍 可 以 看 到 ， 如 果 能 够 正确 地 书写 需要 的 配置 注释 ， 使 用 XDoclet 还 是 很 方便 的 。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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图 25.1 Ant 安装 成 功 测试 


Ant 安装 完成 后 ， 可 以 看 到 如 下 的 目录 布局 : 


ant 


+-- bin /包括 各 种 二 进 制 启动 命令 
| 
+--lib // 包括 ant 运行 需要 的 包 文件 


| 

+--- docs // 包 括 这 种 文档 

+---ant2 /ant2 运行 需要 的 条 件 的 一 个 简单 描述 
| 

+---images /HTML 文档 中 的 各 种 图 片 


| 
| 
| 
| 
| +--- manual // Ant 文档 
| 


+--- etc // 包括 具有 各 种 功能 的 xsl 文件 


25.1.3 ”编写 应 用 类 文件 


在 这 里 编写 一 个 JavaBeans 文件 和 JSP 文件 ， 然 后 使 用 Ant 编译 JavaBeans， 并 把 编译 
后 的 字 节 码 文件 复制 到 某 个 Web 应 用 的 合适 目录 下 ， 使 用 的 JavaBeans 文件 代码 如 下 : 


package cn.ac.ict; 


import java.io.Serializable; 
import java.util.Date ; 


public class Product implements Serializable{ 
//JavaBeans 的 属性 

private String pname; 

private String pcomp; 

private Date pmadeyear; 

private float price; 

private int amount'; 


public Product(){ 


//JavaBeans 属性 的 获取 和 设置 方法 
public String getPname(){ 
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return pname; 
public String getPcomp(){ 
return pcomp; 


} 


public Date getPmadeyear(}{ 
return pmadeyear; 


b 

public float getPrice(){ 
return price; 

b 


public int getAmount(){ 
return amount; 


} 


public void setPname(String productname}{ 
pname = productname; 

} 

public void setPcomp(String productcomp){ 
pcomp = productcomp; 


} 


public void setPmadeyear(Date madeyear){ 
pmadeyear = madeyear; 

} 

public void setPrice(float price){ 
this.price = price; 


} 


public void setAmount(int pamount}{ 
amount = pamount; 


} 


| 
使 用 的 JSP 文件 的 代码 如 下 : 
<%@ page language="java" pageEncoding="GB2312" %> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 

<head> 

<title> 添 加 商品 JSP 页 面 </title> 

</head> 
<body bgcolor="#FFFFFF"> 
<jsp:useBean id="product" scope="request" class="cn.ac.ict.Product" /> 
<jsp:setProperty name="product" property="™*" /> 


<form action="addproduct.jsp" method="get"> 


“457。 
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<table width="580" border="0" cellspacing="0" cellpadding="0" align="center"> 
<thead> 添 加 新 的 商品 </thead> 
<tr> 
<td> 商 品名 称 </td> 
<td><input name="pname" type="text"></td> 
</tr> 
<tr> 
<td> 生 产 商家 </td> 
<td><input name="pcomp" type="text"></td> 
</tr> 
<tr> 
<td> 生 产 日 期 </td> 
<td><input name="pmadeyear" type="text"></td> 
</tr> 
<tr> 
<td> 价 格 </td> 
<td><input name="price" type="text"></td> 
</tr> 
<tr> 
<td> 数 量 </td> 
<td><input name="amount" type="text"></td> 
</tr> 
<tr> 
<td><input name="submit" type="button" value=" 提 交 "></td> 
<td><input name="reset" type="button" value=" 重 置 "></td> 
</tr> 
</table> 
</form> 


</body> 
</html> 


25.1.4 ”编写 相关 的 build.xml 文件 


准备 好 了 需要 使 用 的 Java 文件 和 JSP 文 件 后 ,就 可 以 编写 运行 Ant 需要 使 用 的 build.xml 
文件 了 ， 下 面 是 build.xml 文件 的 完整 代码 : 


<!-- ”定义 的 Project 名 称 、 默 认 执行 的 target 是 dist  --> 
<project name="SimpleProject" default="dist" basedir="."> 
<description> 
simple example build file 
</description> 
<!-- ”定义 全 局 属性 -> 
<property name="src" location="src"/> 
<property name="dist” location="dist"/> 


<!-- 名 为 init 的 target， 它 完成 建立 临时 目录 的 工作 ， 并 把 需要 使 用 的 源 文件 复制 到 合适 位 置 --> 
<target name="init"> 
<mkdir dir="${dist}"/> 
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<mkdir dir="${disty/WEB-INF"> 
<mkdir dir="${distyWEB-INF/classes"/> 
<copy todir="${dist}" > 
<fileset dir="${src}"> 
<include name="™.jsp" /> 
<exclude name="build.xml" /> 
</fileset> 
</copy> 
<copy todir="${distHWEB-INF" > 
<fileset dir="${src}"> 
<include name="web.xml" /> 
<exclude name="build.xml" /> 


</fileset> 
</copy> 
</target> 
<!-- ”名 为 compile 的 target， 它 编译 JavaBeans 文 件 --> 


<target name="compile" depends="init" 
description="compile the source " > 
<javac srcdir="${src}" destdir="${distyWEB-INF/classes"/> 
</target> 


<!-- ”名 为 dist 的 target， 它 将 Web 应 用 打包 --> 
<target name="dist" depends="compile" 
description="generate the distribution" > 
<jar destfile="${basedir}/FirstAnt.war" basedir="${dist}"/> 
</target> 


<!-- 删除 编译 和 发 布 时 使 用 的 临时 目录 --> 
<target name="clean" 
description="clean up" > 
<delete dir="${dist}"/> 
</target> 
</project> 


25.1.5 ”使 用 Ant 运行 


Ant 命 可 以 看 到 命令 行 提示 效果 如 图 25.3 所 示 。 


HB se 


国 Product. java 
"addproduct. jsp 


web. Xml 
法] build xml 
图 25.2 Web 应 用 的 目录 结构 图 25.3 命令 


行 提示 效果 
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所 有 的 文件 都 准备 好 后 ， 这 个 Web 应 用 的 目录 结构 如 图 25.2 所 示 。 在 该 目录 下 运行 
令 ， 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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25.2.2 target 元 素 介 绍 


一 个 项 目 可 以 定义 一 个 或 多 个 target， 一 个 target 是 一 系列 想 要 执行 的 任务 的 集合 。 执 
行 Ant 时 ， 可 以 选择 执行 哪个 target。 当 没有 给 定 target 时 ， 使 用 project 的 default 属性 所 确 
定 的 target。 
一 个 target 可 以 依赖 于 其 他 的 target。 例 如 ， 可 能 会 有 一 个 target 用 于 编译 程序 ， 一 个 
target 用 于 生成 可 执行 文件 。 在 生成 可 执行 文件 之 前 必须 先 编译 通过 ， 所 以 生成 可 执行 文件 
的 target 依赖 于 编译 target。Ant 会 自动 处 理 这 种 依赖 关系 。 

然而 ，Ant 的 depends 属性 只 指定 了 target 应 该 被 执行 的 顺序 ， 如 果 被 依赖 的 target 无 
法 运行 ， 这 种 depends 对 于 指定 了 依赖 关系 的 target 就 没有 影响 。 

Ant 会 依照 depends 属性 中 target 出 现 的 顺序 〈 从 左 到 右 ) 依次 执行 每 个 target。 然 而 ， 
要 记 住 的 是 只 要 某 个 target 依赖 于 一 个 target， 后 者 就 会 被 先 执行 。 

<target name="A"/> 

<target name="B" depends="A"/> 

<target name="C" depends="B"/> 

<target name="D" depends="C,B,A"/> 

假定 要 执行 target D。 从 它 的 依赖 属性 来 看 ,可 能 认为 先 执行 C, 然后 B, 最 后 A 被 执行 。 
不 过 ， 由 于 C 依赖 于 B，B 依赖 于 A， 所 以 先 执 行 A， 然 后 B， 然 后 C， 最 后 D 被 执行 。 

target 元 素 支持 的 属性 包括 name、depends、if、unless 和 description， 如 表 25.2 所 示 。 


表 25.2 target 元 素 的 属性 描述 


属 性 名 是 否 必需 
name 是 
depends 依赖 表 ， 用 逗号 分 隔 的 target 的 名 字 列 表 耕 
if 执行 target 需 要 设 定 的 属性 名 否 
unless 执行 target 需 要 清除 设 定 的 属性 名 否 
description 关于 target 功 能 的 简短 描述 


如 果 (或 如 果 不 ) 某 些 属性 被 设 定 才 执 行 某 个 target。 这 样 ， 允 许 根据 系统 的 状态 (Java 
version、OS、 命 令 行 属性 定义 等 ) 来 更 好 地 控制 build 的 过 程 。 要 想 让 一 个 target 这 样 做 ， 
应 该 在 target 元 素 中 加 入 if (或 unless) 属性 ， 以 及 target 应 该 有 所 判断 的 属性 。 例 如 : 


<target name="build-module-A" if="module-A-present"/> 
<target name="build-own-fake-module-A" unless="module-A-present"/> 


如 果 没 有 让 或 unless 属性 ，target 总 会 被 执行 。 
25.2.3 task 元 素 介 绍 


一 个 task 是 一 段 可 执行 的 代码 。 一 个 task 可 以 有 多 个 属性 。 属 性 只 可 能 包含 对 property 
的 引用 。 这 些 引用 会 在 task 执行 前 被 解析 。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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这 个 例子 是 用 于 编译 Java 源 程序 的 ， 其 中 srcdir 指定 源 文件 所 在 的 目录 ; destdir 指定 
编译 后 的 class 文件 存放 的 目录 ; includes 表示 只 有 mypackage/pl 和 mypackage/p2 目录 下 的 
文件 必须 被 包含 ， 而 excludes 表示 mypackage/pl/testpackage/ 目 录 下 的 文件 被 排除 在 外 ， 
classpath 指定 了 编译 这 个 文件 使 用 的 类 路 径 ，debug 表示 是 否 有 调试 信息 。 

<jar destfile="${dist}/lib/app.jar" 


basedir="${fbuildyclasses" 
excludes="**/Test.class" 


/> 


这 个 例子 是 用 于 把 文件 打包 的 ， 其 中 destfile 指定 了 打包 后 包 的 文件 名 ; basedir 指定 被 
1 含 文件 的 基 路 径 ， 而 excludes 则 表示 任何 目录 下 的 Test.class 文件 都 不 被 打包 。 


<java classname="test.Main"> 
<arg value="-h"/> 
<classpath> 
<pathelement location="dist/test.jar"/> 
<pathelement path="${java.class.path}"/> 
</classpath> 
</java> 


这 个 例子 用 于 执行 Java 程序 ，classname 指定 了 被 执行 的 类 的 完整 类 名 ; <arg> 定 义 了 
传 给 这 个 类 的 参数 ，<classpath> 元 素 定 义 了 运行 需要 的 类 路 径 信息 。 


25.2.6 build.xml 实例 分 析 


在 25.1 节 中 介绍 了 一 个 使 用 Ant 的 实际 例子 , 现在 对 其 使 用 的 build.xml 文件 进行 分 析 ， 
以 便 更 好 地 理解 如 何 编写 build.xml 文件 。 


<!-- ”定义 的 project 名 称 、 默 认 执行 的 target 是 dist  --> 
<project name="SimpleProject" default="dist" basedir="."> 
<description> 
simple example build file 
</description> 
<!-- 定义 全 局 属性 --> 
<property name="src" location="src"/> 
<property name="dist” location="dist"/> 


<!-- 名 为 init 的 target， 它 完成 建立 临时 目录 的 工作 ， 并 把 需要 使 用 的 源 文件 复制 到 合适 位 置 -> 
<target name="init"> 
<mkdir dir="${dist}"/> 
<mkdir dir="${disty/WEB-INF"/> 
<mkdir dir="${distyWEB-INF/classes"/> 
<copy todir="${dist}" > 
<fileset dir="${src}"> 
<include name="™.jsp" /> 
<exclude name="build.xml" /> 
</fileset> 
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</copy> 
<copy todir="${distHWEB-INF" > 
<fileset dir="${src}"> 
<include name="web.xml" /> 
<exclude name="build.xml" /> 
</fileset> 
</copy> 
</target> 


<!-- ”名 为 compile 的 target， 它 编译 JavaBeans 文件 -> 
<target name="compile" depends="init" 


description="compile the source " > 
<javac srcdir="${src}" destdir="${distyWEB-INF/classes"/> 
</target> 


<l-- ”名 为 dist 的 target， 它 将 Web 应 用 打包 --> 
<target name="dist" depends="compile" 
description="generate the distribution" > 
<jar destfile="${basedir}/FirstAnt.war" basedir="${dist}"/> 
</target> 


<!-- 删除 编译 和 发 布 时 使 用 的 临时 目录 --> 
<target name="clean" 
description="clean up" > 
<delete dir="${dist}"/> 
</target> 
</project> 
在 这 个 文件 中 首先 定义 了 project 的 名 称 是 SimpleProject 及 其 属性 (默认 执行 的 target 
是 dist、 基 路 径 是 当前 路 径 ) ， 之 后 定义 了 两 个 全 局 的 属性 ，src 表示 源 程序 目录 ， 另 外 一 
个 为 发 布 需要 的 临时 目录 。 
之 后 定义 了 4 个 target， 分 别 完成 初始 化 、 编 译 、 发 布 和 清除 的 工作 ， 由 于 默认 的 target 
是 dist， 所 以 ， 如 果 在 运行 时 不 指定 target 就 会 运行 dist，dist 依赖 于 compile， 而 compile 
又 依赖 于 init， 所 以 ， 先 执行 init， 然 后 执行 compile， 最 后 才 执 行 dist。 


25.3 用 Ant 发 布 复杂 Web 应 用 


本 节 继 续 介 绍 一 个 实际 使 用 Ant 的 例子 ， 在 这 个 例子 中 ， 需 要 使 用 特定 的 包 文 件 才能 
编译 一 些 文件 ， 相 对 复杂 一 点 ， 本 例 使 用 的 是 第 20 章 中 使 用 的 Struts 用 户 登录 的 例子 。 
使 用 Ant 之 前 ， 先 来 看 一 下 Struts 用 户 登录 应 用 的 程序 结构 ， 如 图 25.5 所 示 。 


25.3.1 build.xml 文件 


build.xml 的 作用 是 创建 一 个 临时 目录 ,然后 在 这 个 临时 目录 下 创建 Web 应用， 把 Web 
应 用 打包 后 发 布 到 Web 服务 器 。 下 面 是 build.xml 文件 的 源 代码 : 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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<copy todir="${dist.dir}" > 
<fileset dir="${basedir}" > 
<include name="pages/*.jsp" /> 
<include name="™.jsp" /> 
<include name="images/*™" /> 
</fileset> 
</copy> 
<copy todir="${dist.dirNWEB-INF/classes" > 
<fileset dir="${basedir}"> 
<include name="resources/*.properties" /> 
</fileset> 
</copy> 
<copy todir="${dist.dirNWEB-INF/" > 
<fileset dir="${basedir}" > 
<include name="™.tld" /> 
<include name=™.xml" /> 


户 
</fileset> 
</copy> 


</target> 


<! -编译 文件 -一 -> 
<target name="compile" depends="init"> 
<javac srcdir="${src.dir}" destdir="S${dist.dirYWEB-INF/classes"> 
<classpath refid="web.classpath"/> 

</jiavac> 

</target> 

<! --- 复制 类 库 文件 ----> 

<target name="copyjar" depends="compile"> 

<copy todir="S${dist.dirYWEB-INF/lib"> 

<fileset dir="${struts.home}"> 
<include name="antir.jar"/> 
<include name="commons-beanutils.jar"/> 
<include name="commons-digester.jar"/> 
<include name="commons-fileupload.jar"/> 
<include name="commons-logging.jar"/> 
<include name="commons-validator.jar"/> 
<include name="jakarta-oro.jar"/> 
<include name="struts.jar"/> 
</fileset> 
</copy> 


</target> 
<!-- 部 署 --> 
<target name="deploy" depends="copyjar"> 
<jar destfile="${tomcat.home}/webapps/${app.name}.war" basedir="S${dist.dir}"/> 
</target> 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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图 25.6 发 布 Web 应 用 


注意: 读者 在 练习 发 布 这 个 应 用 时 要 注意 修改 build.properties 文件 中 Tomcat 的 主 目录 和 
Struts 的 包 文件 所 在 的 共同 主 目录 。 


25.4 人 小 结 


Ant 工具 是 Apache 的 一 个 开放 源 代码 的 项 目 ， 它 是 一 个 非常 优秀 的 软件 构建 工具 。 用 
Ant 编译 或 运行 比较 大 的 工程 是 非常 方便 的 ， 每 个 工程 都 有 一 个 包含 与 这 个 工程 以 及 需要 
Ant 执行 的 任务 信息 的 文件 , 这 个 文件 在 Ant 中 默认 是 build.xml, 也 可 以 在 Ant 执行 时 指定 
使 用 的 构建 文件 。 在 本 章 中 介绍 了 如 何 编写 Ant 的 构建 文件 ， 这 个 文件 的 编写 是 使 用 Ant 
的 重点 和 难点 , 希望 读者 多 尝试 ,体会 其 用 法 。 在 25.3 节 中 介绍 了 使 用 Ant 发 布 JMail Web 
应 用 的 例子 ， 并 解释 了 每 个 目标 完成 的 工作 。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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显示 它 的 欢迎 界面 ， 如 图 26.1 所 示 。 
Eee x 


图 26.1 ”Eclipse 的 欢迎 界面 
关闭 欢迎 界面 后 ， 可 以 看 到 Eclipse 的 默认 界面 (资源 透视 图 ) ， 如 图 26.2 所 示 。 
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图 26.2 ”Eclipse 的 默认 界面 (资源 透视 图 ) 
2. 安装 多 国语 言 包 插件 
Eclipse 的 一 个 很 大 特点 就 是 支持 插件 ， 而 它 的 国际 化 也 是 通过 插件 来 实现 的 ， 只 要 下 
载 与 SDK 相应 的 多 国语 言 包 插件 就 可 以 实现 软件 的 本 地 化 ， 多 国语 言 包 插件 的 安装 和 
Eclipse 的 安装 一 样 简单 ， 可 以 按照 如 下 步骤 进行 : 
(1) 首先 下 载 多 国语 言 包 (下 载 地 址 : http:/www.eclipse.org) ， 并 把 多 国语 言 包 插件 
压缩 包 解 压 到 本 地 硬盘 。 
(2) 然后 把 解压 目录 下 features 和 plugins 文件 夹 中 的 所 有 文件 夹 复制 到 对 应 的 Eclipse 


目录 中 的 features 和 plugins 文件 夹 下 。 
(3) 重新 启动 Eclipse， 可 以 看 到 Eclipse 的 界面 变 成 了 熟悉 的 中 文 环 境 ， 如 图 26.3 
所 示 。 
全 注意 : 虽然 Eclipse 支持 多 国语 言 ， 但 考虑 到 进一步 的 学 习 ， 在 本 章 后 面 所 有 插件 的 安装 
和 设置 都 是 按照 英文 版 进行 的 。 
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图 26.3 ”Eclipse 的 中 文 默认 界面 (资源 透视 图 ) 
26.2 ”使 用 Eclipse 的 Lomboz 插件 开发 JSP 


26.2.1 Lomboz 插件 介绍 


Lomboz 是 Eclipse 的 一 个 主要 的 开源 插件 (open-source plug-in) ，Lomboz 插件 能 够 使 
Java 开发 者 更 好 地 使 用 Eclipse 去 创建 、 调 试 和 部 署 一 个 100% 基 于 J2EE 的 Java 应 用 服务 器 。 
Lomboz 使 得 Eclipse 将 多 种 J2EE 的 元 素 、Web 应 用 的 开发 和 最 流行 的 应 
用 服务 器 结合 为 一 体 。 
1. Lomboz oe 
Lomboz 的 主要 功能 有 如 下 几 项 : 
使 用 HTML、Servlets、JavaServerIM Page (JSP) 等 方式 建立 Web 应 用 程序 。 
JSP 的 编辑 带 有 高 亮 显示 和 编码 助手 。 
JSP 语法 检查 。 
利用 Wizard 创建 Web 应 用 和 EJB 应 用 。 
利用 Wizard 创建 EJB 客户 端 测试 程序 。 
支持 部 署 J2EE Web 应 用 档案 (EAR) 、Web 模块 文件 (WAR) 和 EJB 档案 文 
件 (JAR) 。 
利用 XDoclet 开发 符合 EJB 1.1 和 EJB 2.0 的 应 用 。 
能 够 实现 端口 对 端口 的 本 地 和 远程 的 测试 应 用 服务 。 
能 够 支持 所 有 的 有 可 扩展 定义 的 Java 应 用 服务 。 
能 够 利用 强大 的 Java 调试 器 调试 正在 运行 的 服务 器 端 代码 (JSP&EJB) 。 
通过 使 用 Wizard 和 代码 生成 器 提高 开发 效率 。 
创建 Web 服务 客户 端的 WSDL 形式 的 文件 。 


OOOOODO 


OOOODODO 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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的 执行 环境 等 信息 。 

(2) 在 图 26.5 中 左边 的 树 中 单 击 Server 左边 的 “十 ”, 在 其 子 树 中 选择 Installed Runtime 
项 , 在 右面 的 面板 中 出 现 其 配置 信息 , 单 击 Add 按钮 , 选择 使 用 的 服务 器 , 作者 使 用 Apache 
Tomcat v5.0.28, 根据 提示 配置 服务 器 安装 主 目录 和 JSDK 的 安装 目录 等 信息 ， 配 置 完成 后 ， 
效果 如 图 26.6 所 示 。 
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图 26.5 Lomboz 插件 安装 成 功 图 26.6 服务 器 配置 


经 过 上 面 的 配置 后 ，Lomboz 插件 需要 的 配置 就 完成 了 。 
26.2.3 ”安装 Tomcat 插件 


1. Tomcat 插件 的 安装 
从 http:/www.sysdeo.com/ 上 免费 下 载 Tomcat 插件 (目前 最 高 版 本 为 3.1， 适 合 应 用 于 
Eclipse 3.0 和 Eclipse 3.1 版 本 ) ， 下 载 后 解压 缩 压缩 文件 到 临时 目录 ,并 把 临时 目录 中 com. 
Sysdeo.eclipse.tomcat_X.X.X (X.X.X 为 版 本 号 ) 文件 夹 复制 到 Eclipse 主 目录 下 的 plugins 文 
件 夹 就 可 以 了 。 
县 注意 : 如 果 安装 新 的 插件 后 ， 在 保证 版 本 正确 的 情况 下 ,可 以 把 安装 目录 下 configuration 
文件 夹 中 的 org.eclipse.update 目录 删 掉 ， 然 后 重新 启动 Eclipse， 就 可 以 找到 新 安 
装 的 插件 了 。 
2. Tomcat 插件 初始 化 设置 
安装 成 功 后 ， 为 了 能 在 Eclipse 中 使 用 Tomcat 插件 ， 还 需要 进行 一 定 的 初始 化 设置 。 
(1) 选择 工具 栏 的 Window 菜单 命令 ， 在 弹出 的 下 拉 菜单 中 选择 Preferences 命令 。 
(2) 在 弹出 窗口 左边 的 框 中 选择 Tomcat 项 ， 选 择 计算 机 中 安装 的 Tomcat 版 本 ， 并 设 
置 Tomcat 安装 的 主 目录 。 
(3) 单 击 Tomcat 项 左边 的 “十 ”， 单 击 Advanced， 设 置 Tomcat 安装 的 主 目录 。 
(4) 单 击 JVM settings 项 ， 在 其 设置 面板 中 单 击 classpath (Before generated classpath ) 
项 右边 的 Add JAR/ZIP 按钮 ， 添 加 JDK 安装 目录 中 lib 目录 下 的 tools.jar 文件 ， 单 击 Boot 
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图 26.9 选择 新 建 的 服务 器 

(8) 单 击 Next 按钮 ， 在 配置 面板 中 确保 新 建 的 项 目 成 为 被 配置 的 项 目 ， 也 就 是 出 现 
在 右边 的 栏 中 。 

(9) 单 击 Finish 按钮 ， 完 成 设置 ， 这 时 可 以 看 到 Tomcat 开始 启动 。 

(10) Tomcat 启动 完成 后 ， 这 时 会 出 现 一 个 内 翌 的 浏览 器 ， 并 提示 “内 部 服务 器 错误 ”， 
这 时 可 以 修改 浏览 地 址 为 http://127.0.0.1:8080/LomboaJSP/， 这 样 就 可 以 访问 了 ， 因 为 项 目 
中 还 没有 任何 文件 ， 所 以 只 是 显示 Directory Listing For， 页 面 显 示 如 图 26.10 所 示 。 
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图 26.10 ”验证 项 目 配置 
人 注意 : 服务 器 Host 的 名 称 一 定 要 使 用 127.0.0.1， 不 能 使 用 默认 的 localhost， 否 则 会 出 
现 无 法 访问 资源 的 错误 。 
2. 建立 JSP 文 件 
(1) 选择 工具 栏 中 的 File 命令 ,再 选择 New/Other 命令 ， 在 弹出 的 对 话 框 中 选择 JSP。 
(2) 在 弹出 的 面板 中 选择 JSP 文件 的 父 文件 夹 为 LomboaJSP/WebContent， 并 输入 JSP 


文件 的 文件 名 为 HelloWorldjsp， 效 果 如 图 26.11 所 示 。 
(3) 单 击 Next 按钮 后 ， 选 择 使 用 的 JSP 模板 ， 完 成 JSP 文件 的 建立 。 
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此 行 作 为 一 个 断 点 ， 这 时 这 一 行 最 左边 会 出 现 一 个 淡 蓝 色 的 点 。 

(3) 选择 Windows/Open Perspective/Debug 命令 ， 进 入 调试 视图 模式 。 

(4) 在 嵌入 的 浏览 器 中 输入 要 调试 的 JSP 文件 的 访问 路 径 ， 然 后 查看 JSP 文件 ， 可 以 
看 到 断 点 行 左边 的 蓝 点 变 成 了 向 右 指 的 箭头 ， 也 就 是 程序 执行 到 这 一 行 并 停止 了 ， 效 果 如 
图 26.13 所 示 。 
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图 26.13 调试 JSP 文 件 


26.3 小 结 


本 章 简单 介绍 了 如 何 使 用 Eclipse、Tomcat 和 Lomboz 结合 开发 JSP 程序 ,并 使 用 Lomboz 
调试 功能 。Tomcat 和 Lomboz 只 是 Eclipse 众多 插件 中 的 两 个 ,还 有 很 多 非常 有 价值 的 插件 
可 以 使 用 ， 也 可 以 在 很 大 程度 上 方便 JSP 的 编程 ， 即 使 本 章 中 介绍 的 这 两 个 插件 还 有 很 多 
东西 是 在 开发 JSP 时 可 以 用 到 的 ， 读 者 应 注意 多 实践 。 
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口 用 于 J2EE™ 用 程序 快速 开发 的 EJB 2.0 的 可 视 化 设计 器 。 

口 面向 如 下 领先 应 用 程序 服务 器 的 分 发 : Borland 企业 级 服务 器 、 BEA Weblogic、 IBM 
WebSphere 和 iPlanet。 

口 简化 数据 库 应 用 程序 开发 和 分 发 的 向 导 、 工 具 和 组 件 。 

口 Web 应 用 程序 开发 和 采用 JSP 和 Servlets 的 分 发 。 

口 UML 代码 可 视 化 。 

口 重 构 (refactoring) 与 单元 测试 。 

口 集成 领先 版 本 的 控制 系统 。 

口 跨 设备 公布 和 集成 商务 数据 的 XML 工具 。 


27.2 使 用 JBuilder 开发 JSP (实例 ) 


在 本 节 中 介绍 如 何 使 用 JBuilder 开发 JSP 程序 ， 以 一 个 用 户 登录 验证 为 例 ，JSP 页 面 负 
责 视 图 的 显示 ， 另 一 个 Servlet 负责 验证 ， 在 本 节 先 介绍 如 何 开发 JSP 页 面 。 


27.2.1 建立 工程 及 相关 准备 工作 


要 使 用 JBuilder 开发 一 个 完整 的 项 目 ， 首 先 要 建立 一 个 工程 ， 用 来 容纳 所 开发 的 程序 ， 
读者 可 以 按照 如 下 步骤 建立 工程 。 
(1) 运行 JBuilder 程序 后 ， 在 主 界面 的 标题 栏 中 选择 File/New 命令 或 者 在 主 界面 中 直 
接 按 Ctrl+N 组 合 键 打开 Object Gallery 面板 。 
(2) 在 Object Gallery 面板 的 左边 一 栏 中 选择 Project 项 , 在 右边 出 现 多 个 可 以 选择 的 工程 
项 目 ， 在 本 实例 中 双击 第 一 个 Project 项 ， 建 一 个 新 的 空 普通 工程 ， 显 示 页 面 如 图 27.1 所 示 。 
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图 27.1 新 建 工程 


(3) 修改 工程 的 名 称 〈 本 例 中 建议 改 为 HelloJBuilder) 和 保存 的 路 径 ， 单 击 Next 按钮 。 

(4) 在 之 后 两 步 出 现 的 面板 中 根据 提示 项 进行 相应 的 修改 ， 也 可 以 先 使 用 默认 设置 ， 
在 实际 开发 中 根据 需要 再 更 改 。 

(5) 这 样 就 新 建 了 一 个 工程 。 
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27.2.2 ”设置 项 目 相关 属性 


在 本 节 中 介绍 一 些 JBuilder 的 设置 方法 , 虽然 并 不 一 定 与 要 介绍 的 例子 直接 相关 , 但 也 
是 一 些 常 用 设置 。 

1. 新 配置 服务 器 

新 配置 服务 器 是 开发 Web 应 用 经 常用 到 的 操作 ， 毕 竟 JBuilder 不 可 能 包含 所 有 的 服务 
器 配置 (JBuiler 2005 中 只 用 Tomcat 4 和 Tomcat 5， 其 中 Tomcat 5 是 Tomcat 5.0.27) ， 在 
下 面 的 例子 中 以 新 建 一 个 Tomcat 5.0.28 服务 器 为 例 演 示 如 何 新 建 一 个 新 的 服务 器 。 读 者 可 
以 按照 如 下 步骤 新 建 服务 器 。 


全 注意 : 新 配置 的 服务 器 必须 在 本 机 中 安装 ， 例 如 本 例 中 新 配置 一 个 Tomcat 5.0.28 服务 
器 ， 那 么 读者 的 机 器 上 就 要 安装 这 个 软件 。 
(1) 运行 JBuilder 程序 后 ， 在 主 界面 的 标题 栏 中 单 击 Enterprise 项 ， 选 择 Configure 
Servers， 打 开 Configure Servers 面板 。 
(2) 在 左边 的 列表 中 任 选 一 个 可 用 的 服务 器 (显示 为 黑色 ， 不 可 用 的 显示 为 灰色 )， 
单 击 面板 左下 角 的 Copy... 按 钮 ， 弹 出 一 个 Copy Server Wizard 对 话 框 ， 如 图 27.2 所 示 ， 在 
各 个 栏 中 设置 完成 后 单 击 OK 按钮 。 


a 


图 27.2 设置 新 服务 器 


(3) 可 以 看 到 在 Configure Servers 面板 的 左边 一 栏 中 出 现 一 项 Tomcat 5.0.28， 选 中 这 
一 项 ， 并 在 右边 的 各 个 栏 中 设置 相关 属性 。 

(4) 首先 设置 服务 器 的 安装 目录 , 笔者 的 Tomcat 5.0.28 安装 在 D:\Tomcat 5.0; 然后 是 
设置 启动 时 使 用 的 类 ， 对 于 Tomcat 而 言 是 org.apache.catalina.startup.Bootstrap， 如 果 读 者 设 
置 其 他 服务 器 可 以 参考 其 相关 文档 ; 之 后 还 可 以 指定 虚拟 机 参数 和 服务 器 参数 ， 下 面 还 可 
以 设置 服务 器 的 源 程序 、 相 关 文 档 和 需要 的 库 文件 等 项 ， 这 些 可 以 根据 需要 设置 ， 本 例 中 
采用 默认 设置 。 

(5) 单 击 OK 按钮 完成 设置 ， 这 样 就 可 以 在 新 建 Web Module 时 选择 这 个 新 配置 的 服 
务 器 了 。 
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2. 设置 项 目 属性 

按照 上 面 的 介绍 新 建 完 成 一 个 空 的 项 目 后 ， 往 往 还 会 有 很 多 的 属性 需要 更 改 ， 下 面 对 
一 些 设置 进行 简单 介绍 。 

(1) 在 Project 栏 中 选择 需要 更 改 属性 的 工程 ， 右 击 这 个 工程 的 名 字 , 在 弹出 的 菜单 中 
选择 Properties.…. 命 令 ， 出 现 属性 设置 面板 。 

(2) 在 属性 设置 面板 中 有 很 多 属性 可 以 设置 ， 这 里 不 一 一 介绍 ， 只 选择 几 项 介绍 。 

(3) 修改 编译 选项 : 在 左边 栏 中 选择 Build 下 的 Java， 可 以 在 右边 的 面板 中 设置 使 用 
的 编译 器 ， 调 试 的 选项 以 及 目标 虚拟 机 版 本 等 。 

(4) 更 改 代 码 的 格式 : 左边 栏 中 Basic Formating 和 Java Formating 项 及 其 子 项 都 是 用 
来 设置 代码 格式 的 ， 读 者 可 以 更 改 代码 的 格式 ， 这 样 可 以 保持 代码 具有 统一 的 风格 ， 便 于 
维护 。 

(5) 修改 相关 路 径 : 在 左边 栏 中 选择 Paths 项 ， 在 右边 栏 中 可 以 修改 的 路 径 有 源 代码 
的 路 径 、 输 出 的 路 径 、 备 份 的 路 径 以 及 工作 路 径 等 ， 读 者 可 以 根据 需要 修改 ， 下 面 将 介绍 
如 何 添加 需要 使 用 的 包 。 

3. 给 项 目 添加 需要 使 用 的 包 文件 

随 着 项 目的 不 断 变 大 ， 可 能 需要 不 断 添加 新 的 支持 包 ， 在 本 实例 中 需要 使 用 数据 库 驱 
动 程序 ， 在 下 面 就 以 为 项 目 添加 数据 库 驱 动 程序 包 为 例 介绍 如 何 为 项 目 添加 需要 使 用 的 包 
文件 。 

(1) 在 Project 栏 中 选择 需要 更 改 属性 的 工程 ， 右 击 这 个 工程 的 名 字 , 在 弹出 的 菜单 中 
选择 Properties... 命 令 ， 出 现 属性 设置 面板 。 

(2) 在 左边 栏 中 选择 Paths 项 ， 在 右边 页 面 的 下 部 选择 Required Libraries 选项 卡 。 

(3) 单 击 Add 按钮 ， 选 择 Libraries 选项 卡 ， 单 击 右 边 的 New 按钮 。 

(4) 弹出 New Library Wizard 对 话 框 ， 设 定 其 名 字 为 MySQL Driver， 指 定 包 存 在 的 位 
置 为 Project， 在 后 面 指定 包 存 在 的 路 径 ， 单 击 OK 按钮 完成 设置 。 

(5) 这 样 在 Libraries 选项 卡 下 面 的 框 中 应 该 出 现 一 个 MySQL Driver 项 就 可 以 了 。 


27.2.3 ”新建 Web Module 


(1) 运行 JBuilder 程序 后 ， 在 主 界面 的 标题 栏 中 选择 File/New 命令 或 者 在 主 界面 中 直 
接 按 Ctrl+N 组 合 键 打开 Object Gallery 面板 。 

(2) 在 Object Gallery 面板 的 左边 一 栏 中 选择 Web 项 ， 在 右边 出 现 多 个 可 以 选择 的 工 
程 项 目 ， 在 本 实例 中 双击 第 一 个 Web Module (WAR) ， 建 立 一 个 新 的 Web Module， 显 示 
页 面 如 图 27.3 所 示 。 

(3) 在 第 一 个 下 拉 列 表 中 选择 这 个 Web Module 使 用 的 服务 器 ， 在 图 27.3 中 可 以 看 到 
只 有 两 项 可 以 选择 ， 读 者 可 以 根据 需要 自己 添加 使 用 服务 器 〈 见 27.2.2 节 介 绍 ) 。 

(4) 单 击 OK 按钮 ， 出 现 Web Module Wizard 面板 ， 一 共 分 3 步 ， 在 这 些 面 板 中 可 以 
修改 Web Module 的 名 字 〈 本 例 中 笔者 设置 为 LogInMod) 、 存 放 的 目录 〈 本 例 中 设置 为 该 
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工程 所 在 目录 下 的 LogInMod 目录 )、 使 用 的 Servlet 
版 本 (本 例 为 2.4 版 ) 和 JSP 版 本 (本 例 为 2.0 版 本 )， 
访问 使 用 的 Context 路 径 〈 本 例 为 LogInMod) 等 ， 
这 里 不 作 详细 介 绍 。 

(5) 单 击 Finish 按钮 后 ， 会 出 现 一 个 该 Web 
Module 的 配置 界面 ， 在 其 中 可 以 设置 会 话 的 超时 时 
间 、 图 标 等 信息 ， 对 应 于 Web 应 用 的 web.xml 文件 
中 的 某 个 元 素 ， 读 者 可 有 选择 地 进行 设置 ， 本 例 中 
均 使 用 默认 设置 。 

(6) 这 样 一 个 Web Module 就 建 好 了 。 


ssl ea 
27.2.4 开发 JSP 图 27.3 新 建 Web Module 


在 本 小 节 中 介绍 如 何 使 用 JBuilder 的 JSP Wizard 创建 一 个 JSP 页面， 读者 可 以 按照 如 
下 步骤 进行 。 
(1) 运行 JBuilder 程序 后 ， 在 主 界面 的 标题 栏 中 选择 File/New 命令 或 者 在 主 界面 中 直 
接 按 Ctrl+N 组 合 键 打开 Object Gallery 面板 。 
(2) 在 Object Gallery 面板 的 左边 一 栏 中 选择 Web 项 ， 在 右边 出 现 多 个 可 以 选择 的 工 
程 项 目 ， 在 本 实例 中 双击 JSP 项 ， 建 立 一 个 新 的 JSP 文件 ， 弹 出 JSP Wizard 页 面 。 
(3) 在 第 1 个 面板 的 各 个 设置 中 指定 JSP 文件 的 名 字 为 login.jsp。 
(4) 在 第 2 个 面板 中 编辑 JSP 文件 的 一 些 细节 ， 如 背景 颜色 、 是 否 产生 一 个 FORM 
表单 以 及 使 用 何 种 MVC 框架 等 ， 本 例 中 使 用 默认 设置 。 
(5) 在 第 3 个 面板 中 可 以 添加 使 用 的 Bean， 本 例 不 使 用 任何 Bean 。 
(6) 在 第 4 个 面板 中 可 以 设置 JSP 运行 环境 配置 ， 本 例 中 不 需要 。 
(7) 到 此 ， 一 个 JSP 页 面 就 建 好 了 ， 读 者 可 以 在 出 现 的 JSP 文件 编辑 区 中 编辑 该 JSP 
文件 ， 编 辑 完成 的 JSP 文件 〈login.jsp) 代码 如 下 : 
<%@ page contentType="text/html; charset=GBK" %> 
<html> 
<head> 
<title> 
用 户 登录 
</title> 
</head> 
<body bgcolor="##fffff"> 
<h1> 
用 户 登录 界面 
</h1> 
<form method="post" action="LoglnServlet"> 
<br><br> 
用 户 名 : 
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<input type="text" name="username'"/><br><br> 
密 &nbsp;&nbsp;&nbsp;&nbsp; 码 : 
<input type="password" name="password"/><br><br> 
<input type="submit" name="Submit" value=" 提 交 "> 
<input type="reset" value=" 重 置 "> 
</form> 
</body> 
</html> 


27.3 使 用 JBuilder 开发 Servlet ( 实例 ) 


在 27.2 一 节 介绍 了 如 何 开发 JSP 页 面 ， 并 介绍 了 一 个 简单 的 用 户 登录 的 例子 ， 在 本 节 

中 开发 一 个 Servlet 用 于 对 用 户 信息 进行 确认 。 读 者 可 以 按照 如 下 步骤 进行 : 

(1) 运行 JBuilder 程序 后 ， 在 主 界面 的 标题 栏 中 选择 File/New 命令 或 者 在 主 界面 中 直 
接 按 Ctrl+N 组 合 键 打开 Object Gallery 面板 。 

(2) 在 Object Gallery 面板 的 左边 一 栏 中 选择 Web 项 ， 在 右边 出 现 多 个 可 以 选择 的 工 
程 项 目 , 在 本 实例 中 双击 Standard Servlet 项 , 建立 一 个 新 的 Servlet 文件 , 弹出 Select Server 
对 话 框 。 

(3) 在 其 中 选择 本 工程 使 用 的 服务 器 (在 27.2.3 节 中 新 配置 的 Tomcat 5.0.28) ， 单 击 
OK 按钮 ， 弹 出 Servlet Wizard 对 话 框 。 

(4) 在 Servlet Wizard 对 话 框 (分 5 步 完成 ) 中 设置 类 名 为 LoginCongfirm， 包 名 为 
hellojbuilder， 使 用 的 Web Module 是 27.2.2 节 中 建立 的 LoginMod。 

(5) 在 第 2 和 第 3 个 对 话 框 中 设置 实现 的 方法 、 内 容 的 类 型 、 获 取 的 请 求 参 数 〈 本 例 
中 使 用 两 个 ， 分 别 是 username 和 password， 效 果 如 图 27.4 所 示 ) 。 


ad parameter Remove Parameter 
-eu |[ ess | mu | crm | mw | 
图 27.4 为 Servlet 添加 请 求 参数 
(6) 在 第 4 个 页 面 中 指定 Servlet 的 名 字 和 映射 使 用 的 名 字 ， 这 里 默认 使 用 LoginServlet 
和 /LoginServlet， 在 第 5 个 页 面 中 使 用 默认 设置 就 可 以 了 。 
(7) 单 击 Finish 按钮 ， 完 成 新 建 一 个 Servlet。 
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(8) 编辑 这 个 Servlet 的 代码 ， 最 后 编辑 完成 后 ， 代 码 如 下 : 
package hellojbuilder; 


import javax.servlet.*; 

import javax.servlet.http.*; 
import java.io.*; 

import java.util.*; 

import java.sql.Connection; 
import java.sql.DriverManager; 
import java.sql.SQLException; 
import java.sql.Statement; 
import java.sql.ResultSet; 


public class LoginCongfirm extends HttpServlet { 
private static final String CONTENT_TYPE = "text/html; charset=GBK"; 
private Connection conn=null; 
private String url = "jdbc:mysql://localhost:3306/userLIB"; 
private String user = "root"; 
private String passw = "ict"; 
private boolean legalUser = false; 


// 初 始 化 全 局 变量 ， 加 载 数据 库 驱 动 程序 
public void init() throws ServletException { 
try{ 
Class.forName("com.mysql.jdbc.Driver").newlInstance(); 
conn = DriverManager.getConnection(url,user,passw); 
}catch (ClassNotFoundException ex) { 
this.getServletContext().log(" 无 法 找到 驱动 程序 ",ex); 
} catch (lllegalAccessException ex) { 
this.getServletContext().log(" 无 法 获取 访问 驱动 程序 的 权限 ",ex); 
/* @todo Handle this exception */ 
} catch (InstantiationException ex) { 
this.getServletContext().log(" 无 法 获取 连接 ",ex); 
/* @todo Handle this exception */ 
} catch (SQLException ex) { 
this.getServletContext().log("SQL 错误 ",ex); 
/* @todo Handle this exception */ 


| 


/处 理 HTTP 的 Get 请 求 
public void doGet(HttpServletRequest request, HttpServletResponse response) throws 
ServletException, IOException { 
String username = request.getParameter("username"); 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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/释放 占用 的 资源 
public void destroy() { 
} 

} 


(9) 建立 数据 库 ， 在 MySQL 数据 库 系统 中 建立 userLib 数据 库 ， 并 建立 userInfo 数据 
表 ， 使 用 的 SQL 语句 如 下 : 
CREATE TABLE 'userinfo' ( 
"username' char(20) default NULL， 
'password' char(20) default NULL 


) 
INSERT INTO "userinfo VALUES (zhw','111111"); 


(10) 上 面 的 各 步 都 准备 好 了 ， 下 面 就 可 以 运行 了 ， 选 择 Run/Run Project 命令 。 
(11) 这 时 会 出 现 内 柑 的 浏览 器 ， 在 地 址 栏 中 输入 http://localhost:8083/LoginMod 
/login.jsp， 并 输入 用 户 名 (zhw)〉 和 密码 (111111) ， 页 面 显示 如 图 27.5 所 示 。 


名 注意 : 输入 的 用 户 名 和 密码 只 要 与 数据 库 中 一 致 即 可 。 
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图 27.5 输入 用 户 名 和 密码 
(12) 提交 后 ， 页 面 显示 如 图 27.6 所 示 。 


re emi ET 
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图 27.6 用 户 登录 成 功 


加 载 中 
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(6) 从 图 27.8 中 可 以 看 到 ， 查 询 结果 中 没有 任何 记录 ， 而 把 程序 使 用 的 SQL 语句 部 
分 选中 ， 查 看 查询 数据 库 时 使 用 的 SQL 语句 ， 效 果 如 图 27.9 所 示 。 


De rm pre ween ees 人 onmnrateaneana ee en pe he me neem roar Bs 


图 27.9 查看 SQL 语句 


(7) 把 使 用 SQL 语句 记录 下 来 ， 放 到 MySQL 数据 库 系统 上 查询 ， 可 以 看 到 的 确 是 找 
不 到 记录 的 ， 也 就 说 明 用 户 的 输入 错误 。 
(8) 至 此 一 个 调试 过 程 就 结束 了 ， 当 直到 其 他 问题 时 读者 可 以 采用 类 似 的 方法 解决 。 


27:5. .Wl\ 结 


在 本 章 中 介绍 了 如 何 使 用 JBuilder 这 个 强大 的 集成 开发 环境 开发 JSP 的 Web 应 用 ， 
JBuilder 的 功能 非常 丰富 ， 开 发 Web 应 用 只 是 其 功能 的 一 小 部 分 ， 读 者 如 果 遇 到 问题 可 以 
参考 其 相关 文档 ， 读 者 应 该 多 使 用 它 开发 一 些小 程序 ， 会 发 现 很 多 操作 都 是 类 似 的 。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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用 。 使 得 开发 和 维护 都 变 得 复杂 ， 而 上 述 J2EE 的 三 层 应 用 体系 结构 就 解决 了 这 个 问题 ， 使 
得 负载 得 到 均衡 、 性 能 得 到 优化 。 
客户 端 | 服务 器 端 服务 器 端 商业 逻辑 企业 信息 系统 
et pr a 
1 浏览 器 ! ' Web 1 i! | | ! EIS | 
| 7 让 服务 器 1 | 从 1 1 
i i | le 
| | bs [ae ! 
ee ” 1 i 1 
Eee 二 全 1 和 1 三 
| | | ‘| seviet 一 一 时 EB|! ki | 
1 桌面 系统 11 1 |= | | | | 
KK 二 3 1 
Java 应 用 |! ' | 1 | | | CD | 
下 ! 1 1 ! ' | 
1 YA 1 
1 其 他 设备 1， 和 | | | | 
| | 忆 下 1 1 
J2EE 客户 喘 | J2EE 平 台 ! ' 


图 28.1 多 层 J2EE 应 用 体系 结构 
28.1.2 ”JBoss 入门 


通常 说 的 J2EE 服务 器 简单 来 说 就 是 能 够 提供 JSP 和 EJB 服务 器 的 软件 , 现在 已 经 有 很 
多 的 J2EE 服务 器 可 供 选择 了 ， 例 如 IBM 的 WebSphere 产品 ，BEA 的 BEA WebLogic 系列 
以 及 开源 的 JBoss 等 , 但 前 两 种 都 是 很 庞大 的 软件 平台 而 且 收 费 也 很 高 , 在 本 章 中 为 了 演示 
如 何 使 用 JSP 和 EJB 构建 J2EE 服务 ， 将 会 使 用 JBoss 作为 2EE 服务 器 。 

1. JBoss 简介 

前 面 介绍 过 , JBoss 是 一 个 开源 的 J2EE 服务 器 , 它 的 最 新 版 保持 并 遵循 最 新 的 J2EE 规 
范 。 从 JBoss 项 目 开 始 至 今 ， 它 已 经 从 一 个 EJB 容器 发 展 成 为 一 个 基于 J2EE 的 Web 操作 
系统 ， 体 现 了 J2EE 规范 中 最 新 的 技术 。 

在 J2EE 应 用 服务 器 领域 ，JBoss 是 发 展 最 为 迅速 的 应 用 服务 器 。 由 于 JBoss 遵循 商业 
友好 的 LGPL 授权 分 发 ， 并 且 由 开源 社区 开发 ， 这 使 得 JBoss 广 为 流 行 。 而 且 ，JBoss 应 用 
服务 器 还 具有 许多 优秀 的 特质 。 

口 它 将 具有 革命 性 的 JMX 微 内 核 服 务 作 为 其 总 线 结构 。 

口 它 本 身 就 是 面向 服务 的 架构 (Service-Oriented Architecture，SOA) 。 

口 它 还 具有 统一 的 类 装载 器 ， 从 而 能 够 实现 应 用 的 “ 热 ”部 署 和 “ 热 ” 镍 载 能 
各 注意 : “ 热 ”部 署 的 意思 就 是 部 署 Bean 时 只 需要 简单 复制 Bean 的 JAR 文件 到 部 署 路 径 

下 就 可 以 了 ， 如 果 Bean 已 经 被 LOAD，JBOSS 孝 载 它 ， 然 后 LOAD 一 个 新 版 本 
Bean。 


因此 ， 它 是 高 度 模块 化 的 和 松 耦 合 的 。JBoss 用 户 反馈 显示 ，JBoss 应 用 服务 器 是 健壮 


加 载 中 
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加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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} 

// 下 面 的 方法 是 会 话 EJB 的 生命 周期 方法 ， 可 以 不 实现 
public void ejbActivate() throws EJBException, RemoteException { 
} 


public void ejbCreate() throws CreateException{ 

} 

public void ejbPassivate() throws EJBException, RemoteException { 
} 


public void ejbRemove!() throws EJBException, RemoteException { 


} 

public void setSessionContext(SessionContext arg0) throws EJBException, RemoteException 
[ 

// 具 体 实现 Remote 接口 文件 中 定义 的 方法 ， 它 返回 一 个 字符 串 

public String getWelcome(){ 

return "Hello EJB"; 

} 

} 


在 上 面 的 代码 中 可 以 看 到 HelloEJBBean 中 定义 了 方法 : ejbCreate()、ejbRemove() 、 
setSessionContext()、ejbPassivate()、ejbActivate() 和 ejbPassivate()， 这 些 方法 是 会 话 Bean 中 
用 于 维护 生命 周期 的 方法 ， 有 具体 介绍 见 本 章 后 面 对 会 话 Bean 的 介绍 。 

4. 编写 EJB 组 件 发 布 描述 文件 

EJB 组 件 由 相关 的 类 文件 和 EJB 的 发 布 描述 文件 构成 ,ejb-jar.xml 文件 是 EJB 组 件 的 发 
布 描述 文件 。 在 该 文件 中 定义 了 EJB 组 件 的 类 型 ， 指 明 其 Remote 接口 、Home 接口 和 
Enterprise Bean 类 对 应 的 Java 类 文件 的 完整 类 名 。 下 面 是 HelloEJB 这 个 EJB 组 件 的 
ejb-jar.xml 文件 内 容 : 

<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE ejb-jar PUBLIC "-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 2.0//EN" 

"http://java.sun.com/dtd/ejb-jar_2_0.dtd"> 

<!--- 定义 一 个 包含 EJB 的 JAR 包 ---> 

<ejb-jar> 

<description> 

This is Hello EJB example 

</description> 
<display-name>HelloBean</display-name> 

<!--- 下 面 定义 EJB 的 信息 ---> 

<enterprise-beans> 
<session> 
<display-name>Hello EJB</display-name> 
<ejb-name>HelloEJB</ejb-name> 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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此 时 ， 在 该 目录 下 会 生成 HelloEJB.jar 文件 。 单 独 发 布 此 EJB 组 件 时 把 这 个 JAR 文件 
复制 到 <JBOSS_HOME>/server/default/deploy 下 就 可 以 了 , 如果 此 EJB 组 件 的 相关 配置 都 正 
确 ，JBoss 启动 时 会 提示 正确 ， 否 则 需要 根据 JBoss 提供 的 错误 信息 对 类 文件 或 配置 文件 进 
行 修改 。 


28.1.5 在 Web 应 用 中 访问 EJB 组 件 


1. 编写 访问 EJB 组 件 的 JSP 文件 
在 本 实例 中 使 用 JSP 文件 获得 EJB 组 件 的 引用 , 并 调用 其 可 用 方法 并 输出 调用 的 结果 : 


<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import="cn.ac.ict.EJBPackage.*"%> 
<%@ page import="javax.naming.”%> 


<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 

<head> 

<title>Lomboz JSP</title> 

</head> 

<body bgcolor="#FFFFFF"> 


<% 
try{ 
// 得 到 初始 化 上 下 文 

InitialContext ctx=new InitialContext(); 
// 查 找到 EJB 的 引用 

Object objRef = ctx.lookup("java:comp/env/ejb/HelloEJB"); 
// 主 接口 

HelloEJBHome 
home=(HelloEJBHome)javax.rmi.PortableRemoteObject.narrow(objRef,cn.ac.ict.EJBPackage.Hell 
oEJBHome.class); 
// 创 建 一 个 EJB 的 实现 类 对 象 

HelloEJB bean = home.create(); 


out.print(bean.getWelcome()); 
}catch(Exception exjf 
out.printin(ex); 
j 
%> 
</body> 
</html> 


从 上 面 的 代码 中 ， 可 以 看 到 如 下 这 段 代码 通过 查找 JNDI 名 获得 该 JNDI 资源 的 远程 引用 : 


InitialContext ic = new InitialContext(); 
Object objRef = ic.lookup("java:comp/env/ejb/HelloEJB"); 
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然后 把 这 个 对 象 转化 为 HelloEJBHome 类 型 : 
HelloEJBHome 
home=(HelloEJBHome)javax.rmi.PortableRemoteObject.narrow(objRef,cn.ac.ict.EJBPackage.Hell 
OoEJBHome.class); 
这 样 就 可 以 调用 home 的 create 方法 了 ， 此 时 ，EJB 容器 会 创建 HelloEJBBean 的 实例 ， 并 
调用 其 ejbCreate 方法 ， 然 后 返回 HelloEJBBean 的 远程 应 用 。 
shopdb = home.create(); 
得 到 HelloEJBBean 的 远程 应 用 后 ， 就 可 以 调用 可 用 的 方法 了 ， 在 程序 中 得 到 欢迎 消息 并 输 
出 到 JSP 页 面 : 


out.print(bean.getWelcome()); 
2. 编写 Web 应 用 访问 EJB 组 件 需 要 的 配置 文件 
要 使 Web 应 用 访问 到 EJB 组 件 需要 两 个 配置 文件 : web.xml (Tomcat 中 Web 应 用 共有 
的 文件 ) 和 jboss-web.xml (Web 应 用 配置 在 JBoss 上 必需 的 文件 ) 。 
在 这 个 Web 应 用 中 需要 访问 28.1.4 节 中 开发 的 EJB 组 件 , 因 此 需要 在 Tomcat 的 web.xml 
文件 中 提供 关于 EJB 组 件 的 信息 〈 使 用 ejb-ref 元 素 ) ， 下 面 是 web.xml 的 完整 代码 : 
<?xml version="1.0" ?> 


<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app_2_3.dtd"> 


<web-app> 


<!-- ### EJB References (java:comp/env/ejb) --> 
<ejb-ref> 
<!-- 访问 EJB 使 用 的 名 字 -- > 
<ejb-refname>ejb/HelloEJB</ejb-refname> 
<!-- EJB 的 类 型 -- > 
<ejb-ref-type>Session</ejb-ref-type> 
<home>cn.ac.ict.EJBPackage.HelloEJBHome</home> 
<remote>cn.ac.icLEJBPackage.HelloEJB</remote> 
</ejb-ref> 


</web-app> 

在 以 上 代码 中 声明 了 对 于 EJB 组 件 HelloEJB 的 应 用 ，ejb-ref-type 声明 了 所 引用 的 EJB 
组 件 的 类 型 (Session) ，home 元 素 声明 了 EJB 的 Home 接口 ，remote 元 素 声 明了 EJB 的 
Remote 接口 ， 在 Web 应 用 中 ， 可 以 通过 ejb-ref-name 所 指定 的 名 字 (不 是 JNDI 的 名 字 ) 
来 获得 EJB 的 引用 ， 代 码 如 下 : 

InitialContext ic = new InitialContext(); 


Object objRef = ic.lookup("java:comp/env/ejb/HelloEJB"); 
要 把 Web 应 用 发 布 到 JBoss 服务 器 上 ， 还 需要 提供 jboss-web.xml 文件 ， 它 指定 了 
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<ejb-ref-name> (在 web.xml 文件 中 指定 的 ) 和 <jndi-name> 的 映射 关系 。jboss-web.xml 文件 
内 容 如 下 : 
<?xml version="1.0" encoding="ISO-8859-1"?> 


<jboss-web> 
<ejb-ref> 
<ejb-ref-name>ejb/HelloEJB</ejb-ref-name> 
<jndi-name>ejb/HelloEJB</indi-name> 
</ejb-ref> 
</jboss-web> 
在 这 个 文件 中 对 访问 EJB 组 件 的 名 字 和 JNDI 名 字 进 行 
了 映射 ， 启 动 这 个 JINDI 名 必须 在 上 节 中 介绍 的 jboss.xml 文 
件 中 定义 。 
3. 给 Web 应 用 打包 并 验证 其 正确 性 


把 相关 的 文件 组 织 好 后 ， 文 件 的 结构 如 图 28.4 所 示 。 = 区 
在 DOS 窗口 中 ， 转 到 Web 应 用 所 在 的 目录 ， 运 行 如 下 [newsw 


命令 : 图 28.4 Web 应 用 文件 结构 


jar cvf HelloEJBWAR.war *.* 

在 Web 应 用 所 在 的 目录 下 (这 里 是 war 文件 夹 ) 会 得 到 HelloEJBWAR.war 文件 。 把 这 
个 文件 复制 到 <JBOSS_HOME>/server/default/deploy 下 可 以 单独 发 布 Web 应 用 (首先 必须 保 
证 EJB 组 件 被 正确 地 发 布 了 ， 因 为 Web 应 用 涉及 对 EJB 的 引用 ， 如 果 EJB 组 件 配 置 错误 ， 
Web 应 用 将 无 法 获得 对 EJB 的 引用 ) 。 


28.1.6 ”在 JBoss 中 发 布 运行 J2EE 应 用 


要 发 布 这 个 J2EE 应 用 , 还 需要 一 个 J2EE 应 用 的 发 布 描述 文件 application.xml， 在 这 个 
文件 中 声明 这 个 JEE 应 用 所 包含 的 Web 应 用 以 及 EJB 组 件 。 如 下 是 该 文件 的 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 

<application> 

<display-name>HelloEJB</display-name> 

<module> 

<-- 在 下 面 分 别 定义 在 这 个 J2EE 应 用 中 使 用 的 Web 组 件 --> 

<web> 
<web-uri>HelloEJBWAR.war</web-uri> 
<context-root>/HelloEJB</context-root> 

</web> 

</module> 

<module> 

<-- 在 下 面 分 别 定义 在 这 个 J2EE 应 用 中 使 用 的 EJB 组 件 --> 

<ejb>HelloEJB.jar</ejb> 


加 载 中 
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网 络 协议 是 什么 ，EJB 使 用 相同 的 编程 API 和 语义 以 Java RMI-IIOP 访问 分 布 式 对 象 。 协 议 

的 细节 对 应 用 程序 和 Bean 开发 人 员 隐 藏 ， 对 于 所 有 供应 商 来 说 ， 定 位 和 使 用 分 布 式 Bean 

的 方法 是 相同 的 。 

全 注意 : Enterprise Bean 与 JavaBeans 不 同 。JavaBeans 是 使 用 java.beans 包 开发 的 ， 是 
Java 2 标准 版 的 一 部 分 .JavaBeans 是 一 台 计 算 机 上 同一 个 地 址 空间 中 运行 的 组 件 ， 
它 是 进程 内 组 件 。Enterprise Bean 是 使 用 javax.ejb 包 开发 的 ， 它 是 标准 JDK 的 扩 
展 ， 是 Java 2 Enterprise Edition 的 一 部 分 。Enterprise Bean 是 在 多 台 计 算 机 上 跨 几 
个 地 址 空间 运行 的 组 件 ， 因 此 Enterprise Bean 是 进程 间 组 件 。JavaBeans 通常 用 作 
GUI 窗口 小 部 件 ， 而 Enterprise Bean 则 用 作 分 布 式 商业 对 象 。 


28.2.2 实体 EJB 


实体 Bean 是 两 种 主要 Bean〈 实 体 和 会 话 ) 中 的 一 种 。 实 体 Bean 用 于 表示 数据 库 中 的 
数据 。 它 向 JDBC 或 其 他 一 些 后 端 API 经 常 访问 的 数据 提供 了 一 个 面向 对 象 的 接口 。 不 仅 
如 此 ， 实 体 Bean 提供 了 一 个 组 件 模型 ， 可 以 让 Bean 开发 人 员 将 精力 集中 在 Bean 的 商业 由 
辑 上 ， 而 容器 负责 管理 持续 、 事 务 和 访问 控制 。 

实体 EJB 用 在 处 理 大 量 、 并 发 的 客户 端 请 求 的 情况 ， 它 在 实现 业务 逻辑 的 同时 ， 作 为 
数据 库 的 一 个 缓冲 。 在 服务 量 大 的 情况 下 ， 能 减轻 数据 库 的 负担 ， 提 高 业务 处 理 能 力 。 

实体 EJB 封装 了 业务 逻辑 实现 ， 并 且 可 以 供 多 个 客户 使 用 。 除 了 实现 业务 逻辑 外 ， 实 
体 EJB 的 属性 可 以 用 来 代表 商业 过 程 中 处 理 的 永久 性 数据 ,一 个 简单 的 实体 Bean 可 以 定义 
成 代表 数据 库 表 的 一 个 记录 ， 也 就 是 每 一 个 实体 对 象 代表 一 条 具体 的 数据 库 记 录 。 更 复杂 
的 实体 Bean 可 以 代表 数据 库 表 间 关联 视图 。 

有 两 种 基本 的 实体 Bean: 容器 管理 的 持续 (CMP) 和 Bean 管理 的 持续 (BMP) 。 容 
器 使 用 CMP 管理 实体 Bean 的 持续 。 供 应 商工 具 用 于 将 实体 字段 映射 到 数据 库 ， 并 且 绝 对 
没有 数据 库 访 问 代 码 写 入 Bean 类 。 使 用 BMP， 实 体 Bean 包含 了 数据 库 访问 代码 〈 通 常 是 
JDBC) ， 负 责 读 取 其 自身 状态 并 将 此 状态 写 入 数据 库 。BMP 实体 对 此 有 很 大 帮助 ， 因 为 容 
器 将 提醒 Bean 何 时 需要 更 新 状态 或 从 数据 库 读 取 状 态 。 容 器 还 可 以 处 理 任何 锁定 或 事务 ， 
因此 数据 库 可 以 保持 完整 性 。 

部 署 在 容器 中 实体 Bean 的 Home 接口 的 实现 是 由 容器 提供 的 。 并 且 容 器 确保 客户 端 能 
够 通过 JNDI 访问 部 署 在 容器 中 的 每 个 实体 Bean 的 Home 接口 。 实 现实 体 Bean Home 接口 
的 对 象 是 EJBHome。 

通过 实体 Bean Home 接口 ， 客 户 端 可 以 进行 如 下 操作 : 
创建 新 的 实体 对 象 。 
查找 存在 的 实体 对 象 。 
删除 实体 对 象 。 
执行 主 罗 辑 方法 。 
获取 主 接口 的 句柄 。 


DOOODOCDO 
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web.zml jboss-web.zml 
jboss.zml 
ejb-ref-name 
2 jndi-name 
ejb-ref-name ] 
jndi-name | 
gb-name 


| 


jb-jar.xml| ejb-name 


图 28.7 Web 应 用 中 使 用 EJB 时 配置 文件 关系 
28.3 ”网 上 书店 一 一 J2EE 应 用 实例 


28.3.1 创建 EJB 组 件 


1. 编写 Remote 接口 文件 

Remote 接口 中 定义 了 客户 可 以 调用 的 业务 方法 ， 这 些 方法 在 Enterprise Bean 类 中 会 得 
到 具体 的 实现 ， 以 下 为 Remote 接口 BookShopDBEJBBean.java 的 代码 : 

package cn.ac.ict.BookStoreOnline; 


import java.rmi.RemoteException; 
import java.util.ArrayList; 


import javax.ejb.CreateException; 
import javax.ejb.EJBObject; 


public interface BookShopDBEJBBean extends EJBObject { 
// 根 据 图 书 ID 获取 一 个 商品 对 象 
public Book getBookbyBid(String pid) throws RemoteException,CreateException; 
// 使 用 指定 的 SQL 语句 查询 数据 库 ， 并 返回 所 有 的 图 书 对 象 集合 
public ArrayList getBooks(String sql) throws RemoteException,CreateException; 


} 
可 以 看 到 在 Remote 接口 中 定义 了 两 个 方法 getBookbyBid 和 getBooks， 这 里 只 作 声 明 ， 不 
提供 具体 实现 。 

2. 编写 Home 接口 文件 


Home 接口 定义 了 创建 、 查 找 和 删除 EJB 的 方法 。 在 本 例 中 只 有 一 个 create 方法 ,该 方 
法 返回 一 个 BookShopDBEJBBean 对 象 (Remote 接口 类 型 ) 的 远程 引用 。 下 面 是 Home 接 
口 BookShopDBEJBHome.java 的 代码 : 
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books = new ArrayList(); 


上 
// 使 用 指定 的 SQL 语句 查询 数据 库 ， 并 返回 所 有 的 商品 对 象 集合 
public ArrayList getBooks(String sql){ 
ResultSet rs = null; 
books.clear(); 
try{ 
Statement stmt = conn.createStatement(); 
rs = stmt.executeQuery(sql); 
while(rs.next())\{ 
Book ptemp = new Book(); 
ptemp.setBookid(rs.getString("bookid")); 
ptemp.setBookname(rs.getString("bookname")); 
ptemp.setPress(rs.getString("press")); 
ptemp.setAuthor(rs.getString("author )); 
ptemp.setPublishdate((java.util.Date)rs.getDate("publishdate")); 
ptemp.setSellDate((java.util.Date)rs.getDate("selldate")); 
ptemp.setRealprice(rs.getFloat("realprice")); 
ptemp.setCutprice(rs.getFloat("cutprice")); 
ptemp.setPicture(rs.getString("pic")); 
ptemp.setAmount(rs.getlnt("amount )); 
ptemp.setHit(rs.getlnt("hit")); 
ptemp.setDescription(rs.getString("description")); 
books.add((Object)ptemp); 
4 
stmt.close(); 
}catch(Exception eX{ 


} 


return books; 


} 
// 根 据 商 品 ID 获取 一 个 商品 对 象 
public Book getBookbyBid(String bookid){ 
return (Book) getBooks("select * from books where bookid="+bookid).get(0); 


} 


public void ejbActivate() throws EJBException, RemoteException { 
} 


public void ejbPassivate() throws EJBException, RemoteException { 


} 


public void ejbRemove!() throws EJBException, RemoteException { 
try{ 
// 关 闭 数据 库 连接 
conn.close(); 
}catch(SQLException se){ 
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<!--- 定义 一 个 无 状态 的 会 话 Bean -一 > 
<session-type>Stateless</session-type> 
<transaction-type>Container</transaction-type> 
</session> 
</enterprise-beans> 
</ejb-jar> 
上 面 发 布 描述 文件 声明 了 一 个 无 状态 的 会 话 Bean (session-type 元 素 指定 ) ， 并 指明 其 
Remote 接口 (remote 元 素 指 定 )、Home 接口 (home 元 素 指 定 ) 和 Enterprise Bean 类 (ejb-class 


元 素 指定 ) 对 应 的 Java 类 文件 。 

要 在 JBoss 上 发 布 EJB 组 件 还 需要 一 个 jboss.xml 文件 ， 它 是 只 有 在 JBoss 上 发 布 EJB 
组 件 时 才 需 要 的 文件 , 在 其 他 的 EJB 容器 中 发 布 时 就 需要 替换 成 其 他 的 文件 ,比如 WebLogic 
使 用 weblogic-ejb-jar.xml 文件 ， 在 这 个 文件 中 为 EJB 指定 JNDI 名 字 ， 下 面 是 文件 的 内 容 : 


<?xml version="1.0" encoding="UTF-8"?> 
<jboss> 
<enterprise-beans> 
<session> 
<ejb-name>bookstore</ejb-name> 
<jndi-name>ejb/bookstorejb</indi-name> 
</session> 
</enterprise-beans> 
</jboss> 


5. 发 布 EJB 组 件 并 验证 其 正确 性 

到 目前 为 止 ，EJB 组 件 的 相关 文件 都 已 经 准备 好 了 ， 对 Java 类 文件 进行 编译 后 ， 把 相 
关 文 件 组 织 好 后 ， 程 序 的 结构 如 图 28.8 所 示 ， 然 后 给 EJB 组 件 打包 并 发 布 。 

在 DOS 窗口 中 ， 转 到 EJB 组 件 所 在 的 日 录 (图 28.8 中 为 ejb 文件 夹 ) ， 然 后 运行 如 下 
命令 : 


jar vcf bookshop.jar *.* 
GB «jb 
GB META-IN 
jb-jar. xnl 
jboss. xml 


EG BookStoreOnline 
项 Book class 
fy BookShopCart. class 
从 BookShopDBEJBBean. class 
他 BookShopDBEJBHome. class 
ny BookShopDBEJBImp]. class 
BookShopUtil. class 
从 ShopBookIten. class 


图 28.8 EJB 组 件 文件 结构 


此 时 ， 在 该 目录 下 会 生成 bookshop.jar 文件 。 单 独 发 布 此 EJB 组 件 时 把 这 个 JAR 文 伯 
复制 到 <JBOSS_HOME>/server/default/deploy 下 就 可 以 了 , 如 果 此 EJB 组 件 的 相关 配置 都 正 
确 ，JBoss 启动 时 会 提示 正确 ， 和 否则 需要 根据 JBoss 提供 的 错误 信息 对 类 文件 或 配置 文件 进 


行 修 改 。 


f 
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引用 可 以 通过 包含 这 个 文件 的 方式 获得 。 这 个 文件 被 命名 为 initjsp《〈 可 以 随意 取 ) ， 下 面 
是 这 个 文件 的 内 容 : 
<%@ page language="java" errorPage="error.jsp" pageEncoding="GB2312" %> 
<%@ page import="javax.ejb.*,javax.naming.*,javax.rmi.*"%> 
<%@ page import="cn.ac.ict.BookStoreOnline.*"%> 
<%@ page import="java.util.”"%> 
<9%6! 
private Book ShopDBEJBBean bookstore; 
public void jspInit(¥{ 
bookstore = (Book ShopDBEJBBean)getServletContext().getAttribute("bookstore"); 
if(bookstore == null){ 
try{ 
// 得 到 初始 化 上 下 文 
InitialContext ic = new lInitialContext(); 
// 查 找到 EJB 的 引用 
Object objRef = ic.lookup("java:comp/env/ejb/bookstorejb"); 
BookShopDBEJBHome home = (BookShopDBEJBHome)PortableRemoteObject.narrow 
(objRef,cn.ac.ict.BookStoreOnline.BookShopDBEJBHome.class); 
// 创 建 一 个 EJB 的 实现 类 对 象 
bookstore = home.create(); 
// 把 这 个 类 对 象 设置 为 ServletContext 范围 的 属性 
getServletContext().setAttribute("bookstore",bookstore); 
}catch(Exception re){ 
System.out.print(re); 
JW 
Wif 
Winit 


public void jspDestroy(){ 
bookstore = null; 


LE 


public String convert(String s\{ 

ty{ 

return new String(s.getBytes("|SO-8859-1"),"GB2312"); 
}catch(Exception eX{ 

return null; 

} 

b 


%> 
从 上 面 的 代码 中 可 以 看 到 如 下 这 段 代码 通 过 查找 JNDI 名 获得 该 JNDI 资源 的 远程 引用 : 
// 得 到 初始 化 上 下 文 

InitialContext ic = new InitialContext(); 


// 查 找到 EJB 的 引用 
Object objRef = ic.lookup("java:comp/env/ejb/bookstorejb"); 


然后 把 这 个 对 象 转化 为 BookShopDBEJBHome 类 型 : 
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应 用 


<application> 
<display-name>bookshop</display-name> 
<module> 
// 下 面 分 别 定义 在 这 个 J2EE 应 用 中 使 用 的 Web 模型 
<web> 
<web-uri>bookshop.war</web-uri> 
<context-root>/bookstore</context-root> 
</web> 
</module> 
<module> 
// 下 面 分 别 定义 在 这 个 J2EE 应 用 中 使 用 的 EJB 模型 
<ejb>bookshop.jar</ejb> 
</module> 
</application> 


以 上 代码 指明 该 PEE 应 用 中 包含 了 一 个 shoponlineWeb 
， 其 WAR 文件 为 bookshop.war， 访 问 路 径 是 /bookstore; 


包含 一 个 EJB 组 件 ， 其 JAR 文件 是 bookshopjar。 


表 页 


统 的 开发 变 得 容易 ,是 企业 级 计算 的 如 
的 技术 手段 ， 可 以 使 读者 在 阅读 本 章 的 基础 上 进一步 了 解 EJB 技术 。 


把 该 实例 需要 的 文件 组 织 后 ,文件 的 结构 如 图 28.10 所 示 。 
在 DOS 窗口 中 , 转 到 J2EE 应 用 的 目录 , 运行 以 下 命令 : 
jar vcf bookshop.ear *.* 


BC er 
9 META-INF 
好 MANIFEST. HF 
2 spplication xnl 
国 bookshop. jr 
bookshop. war 


图 28.10 J2EE 应 用 文件 结构 


此 时 ， 在 这 个 目录 下 将 生成 bookshop.ear 文件 。 这 样 就 可 以 按照 如 下 步骤 发 布 J2EE 应 
用 了 : 


(1) 把 MySQL 数据库 的 驱动 程序 复制 到 <JBOSS_HOME>/server/default/lib 目录 下 。 
(2) 把 bookshop.ear 文件 复制 到 <JBOSS_HOME>/server/default/deploy 目录 下 。 


(3) 启动 MySQL 服务 器 。 


(4) 运行 <JBOSS_HOME>/bin/run.bat， 启 动 JBoss 和 Tomcat 服务 器 。 
(5) 访问 http://localhost:8080/bookshop/list.jsp， 将 会 看 到 这 个 J2EE 应 用 的 所 有 商品 列 


面 。 


28.4 小 结 


EJB 技术 和 JSP 技术 共同 成 为 J2EE 技术 的 两 大 方面 ，EJB 技术 使 得 多 层 结构 的 应 用 系 


要 技术 , EJB 技术 和 JSP 技术 的 结合 使 用 也 是 很 重要 


本 章 首 先 从 一 个 简单 的 例子 出 发 介绍 了 EJB 技术 和 JSP 技术 的 结合 使 用 ， 而 后 简单 介 
绍 了 一 下 EJB 技术 , 最 后 以 一 个 实际 的 网 上 书店 购物 车 的 例子 演示 了 实际 中 如 何 使 用 它们 ， 
读者 应 该 尝试 开发 一 个 系统 ， 才 会 更 好 地 理解 它们 之 间 是 如 何 结合 起 来 的 。 
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服务 
CORBA 是 用 于 分 布 式 计 算 的 成 熟 技 术 ， 在 实际 应 用 中 得 到 了 广泛 的 关注 。 它 与 Web 


应 用 的 结合 也 是 很 重要 的 一 个 方面 。 在 本 章 中 介绍 一 些 CORBA 的 基础 知识 ， 并 讲述 如 何 
实现 CORBA 服务 以 及 如 何在 Tomcat 中 配置 ,使 得 CORBA 技术 和 Web 开发 结合 起 来 应 用 。 


29.1 快速 体验 CORBA 一 -一 使 用 JSP 访问 CORBA 的 
简单 例子 


29.1.1 CORBA 简介 


随 着 因特网 技术 的 日 益 成 熟 ， 学 校 、 商 业 企 业 和 很 多 宽带 用 户 正 享受 着 高 速 、 低 价 网 
络 信 息 传输 所 带 来 的 高 品质 数字 生活 。 但 随 着 网 络 规模 的 不 断 扩大 以 及 计算 机 软 硬 件 技 术 
水 平 的 大 幅 提 高 ， 传 统 的 应 用 软件 系统 的 实现 方式 面临 着 巨大 的 挑战 。 

首先 ， 在 企业 级 应 用 中 ， 硬 件 系 统 集成 商 基于 性 能 、 价 格 、 服 务 等 方面 的 考虑 ， 通 常 
在 同一 系统 中 集成 来 自 不 同 厂商 的 硬件 设备 、 操 作 系统 、 数 据 库 平台 和 网 络 协议 ， 由 此 带 
来 的 异 构 性 给 应 用 软件 的 互 操作 性 、 兼 容 性 以 及 平滑 升级 能 力 带 来 了 严重 问题 。 另 外 ， 随 
着 基于 网 络 的 业务 不 断 增 多 ， 传 统 的 客户 /服务 器 〈C/S) 模式 的 分 布 式 应 用 方式 越 来 越 显示 
出 在 运行 效率 、 系 统 网 络 安全 性 和 系统 升级 能 力 等 方面 的 局 限 性 。 

为 了 解决 分 布 式 计算 环境 (Distributed Computing Environment，DCE) 中 不 同 硬件 设备 
和 软件 系统 的 互联 ， 增 强 网 络 间 软 件 的 互 操 作 性 ， 解 决 传统 分 布 式 计算 模式 中 的 不 足 等 问 
题 ， 对 象 管 理 组 织 (OMG) 提出 了 公共 对 象 请 求 代 理 体系 结构 (CORBA) ， 以 增强 软件 系 
统 间 的 互 操 作 能 力 ， 使 构造 灵活 的 分 布 式 应 用 系统 成 为 可 能 。 

正 是 基于 面向 对 象 技 术 的 发 展 和 成 熟 、 客 户 / 服 务 器 软件 系统 模式 的 普遍 应 用 以 及 集成 
已 有 系统 等 方面 的 需求 ， 推 动 了 CORBA 技术 的 成 熟 与 发 展 。 作 为 面向 对 象 系统 的 对 象 通 
信 的 核心 ，CORBA 为 当今 网 络 计算 环境 带 来 了 真正 意义 上 的 互联 。 

CORBA (Common Object Request Broker Architecture) 是 由 OMG 提出 的 应 用 软件 体系 
结构 和 对 和 象 技 术 规 范 ， 其 核心 是 一 套 标准 的 语言 、 接 口 和 协议 ， 以 支持 异 构 分 布 应 用 程序 
间 的 互 操作 及 平台 无 关 的 编程 语言 的 对 象 重用 。 

OMG 于 1990 年 初步 提出 了 CORBA 思想 ， 到 现在 的 最 新 版 本 是 3.0 版 本 。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 


第 29 章 ”JSP 作为 客户 访问 CORBA 服务 “513。 


public void muti(int a, int b, IntHolder c){ 
c.value=a*b; 


public void div(int a, int b, IntHolder c) { 
c.value=a/b; 
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public void sub(int a, int b, IntHolder c) { 
c.value=a-b; 
} 
} 


其 中 ， 各 个 方法 涉及 的 c 变量 是 a 和 bb 的 运算 结果 ， 都 使 用 了 IntHolder 类 型 ， 用 于 返 
回 结果 。 

3. 编写 服务 端 实现 

下 面 是 服务 器 CalServer.java 的 内 容 : 


import org.omg.CORBA.ORB; 

import org.omg.CosNaming.NameComponent; 

import org.omg.CosNaming.NamingContextExt; 
import org.omg.CosNaming.NamingContextExtHelper; 
import org.omg.PortableServer.POA; 

import org.omg.PortableServer.POAHelper; 


import ArithApp.calculate; 
import ArithApp.calculateHelper; 


public class CalServer { 


public CalServer(){ 
super(); 


b 
public static void main(String args[]) { 


try{ 
// 创 建 并 初始 化 ORB 
ORB orb = ORB.init(args, null); 


// 创 建 一 个 接口 实现 的 例子 ， 并 把 它 向 ORB 注册 
Callmpl impl = new Callmpl(orb); 


// 获 得 RootPOA 的 引用 并 激活 POAManager 

POA rootpoa = POAHelper.narrow( 
orb.resolve_initial_references("RootPOA")); 

rootpoa.the_POAManager().activate(); 


/从 服务 中 得 到 对 象 的 引用 
org.omg.CORBA.Object ref = 
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NamingContextExtHelper.narrow(objRef); 


// 从 命名 上 下 文中 获取 接口 实现 对 象 
String name = "Cal"; 
calculate impl = calculateHelper.narrow(ncRef.resolve str(name)); 


System.out.println("Handle obtained on server object: " + impl); 


int a =90; 

int b =7; 

IntHolder c = new IntHolder(); 

// 调用 乘法 

impl.muti(a,b,c); 

// 输出 结果 

System.out.println("The result of axb is: "+c.value); 
impl.div(a,b,c); 

// 输 出 结果 

System.out.println("The result of as*b is: "+c.value); 
impl.add(a,b,c); 

// 输 出 结果 

System.out.println("The result of a 十 b is: "+c.value); 
impl.sub(a,b,c); 

// 输 出 结果 


System.out.println("The result of a 一 b is: "+c.value); 


} catch (Exception e){ 
System.out.printlin("ERROR : "+ e) ; 
e.printStackTrace(System.out); 

| 


5. 运行 程序 
把 所 有 的 文件 都 编写 并 编译 完成 后 ， 各 个 Java 源 文件 的 存放 位 置 如 图 29.1 所 示 ， 生 成 
的 字 节 码 文 件 放 在 bin 目录 下 ， 与 Java 源 文件 的 字 节 码 文件 在 bin 中 的 相对 位 置 和 在 src 中 
相同 。 按 照 下 面 的 步骤 执行 该 应 用 程序 : 
(1) 启动 orbd， 在 应 用 程序 根 目 录 CorbaApp 下 运行 : 
orbd -ORB InitialPort 3588 
(2) 启动 服务 器 端 ， 在 应 用 程序 根 目录 CorbaApp 下 运行 : 
java CalServer -ORBInitialPort 3588 
(3) 这 时 可 以 看 到 命令 行 提示 服务 器 运行 成 功 并 等 待 客户 端 调用 。 
(4) 启动 客户 端 ， 在 应 用 程序 根 目录 CorbaApp 下 运行 : 
java CalClient -ORB InitialPort 3588 
客户 端 成 功 运行 就 可 以 看 到 如 图 29.2 所 示 的 效果 。 
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效果 


x 


图 29.1 CORBA 应 用 目录 结构 图 图 29.2 CORBA 应 有 


29.2 CORBA 技术 构成 


CORBA 体系 结构 中 设计 的 几 个 核心 概念 有 : 对 象 请 求 代 理 、 接 口 定义 语言 、 对 象 适 配 
器 等 ， 在 本 节 中 将 结合 CORBA 的 体系 结构 介绍 CORBA 架构 中 的 一 些 核心 组 件 和 概念 。 


29.2.1 对象 请 求 代理 〈Object Request Broker，ORB) 


CORBA 体系 结构 的 核心 是 ORB， 简 单 而 言 ，ORB 就 是 使 客户 应 用 程序 能 调用 远 端 对 
象 方法 的 一 种 机 制 。 
当 客 户 端的 应 用 程序 需要 调用 远程 对 象 的 某 个 方法 时 ， 首 先 需 要 得 到 这 个 远程 对 象 的 
引用 ， 这 样 才 可 以 像 调 用 本 地 对 象 的 方法 一 样 调用 远程 对 象 。 当 客户 端 发 出 一 个 调用 请 求 
时 ，ORB 会 截获 这 个 请 求 (通过 客户 Stub 完成 )， 因 为 客户 和 服务 器 有 可 能 在 不 同 的 网 络 、 
不 同 的 操作 系统 上 ， 甚 至 用 不 同 的 语言 实现 ，ORB 还 要 负责 将 调用 的 名 字 、 参 数 等 编码 成 
标准 的 方式 〈 称 为 Marshaling) ， 然 后 通过 网 络 传输 到 服务 器 方 ( 即 使 在 同一 台 机 器 上 也 要 
这 样 进行 ) ， 并 通过 将 参数 Unmarshaling 的 过 程 ， 传 到 正确 的 对 象 上 《这 整个 过 程 称 为 重 
定向 , Redirecting), 服务 器 对 象 完成 方法 调用 后 , ORB 通过 同样 的 Marshaling/Unmarshaling 
方式 将 结果 返回 给 客户 。 
下 面 简单 介绍 一 下 ORB 的 结构 ， 图 29.3 说 明 的 是 客户 端 发 送 一 个 请 求 到 对 象 的 实现 
过 程 。 
客户 端 是 希望 对 某 对 象 执 行 操作 的 实体 。 
对 象 的 实现 是 通过 使 用 一 段 代 码 和 数据 来 实 
现 。ORB 负责 实现 下 面 的 必要 功能 : 对 象 定位 
(对 该 请 求 找到 对 象 的 实现 ) 、 确 信服 务 器 端 
能 接受 请 求 、 把 客户 请 求 重新 定位 到 服务 器 端 
的 对 象 实现 上 并 让 对 象 的 实现 准备 好 接受 请 
求 、 交 换 数 据 。 客 户 端的 接口 完全 独立 于 对 象 ”图 29.3 客户 端 发 送 一 个 请 求 到 对 象 的 实现 
的 位 置 ， 其 实现 的 语言 等 因素 也 不 影响 对 象 接 
口 的 实现 。 图 29.4 展示 的 是 一 个 独立 的 ORB 的 结构 。 
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29.2.3 接口 仓库 (Interface Repository，IR) 


接口 仓库 ， 顾 名 思 义 可 以 理解 为 CORBA 分 布 式 对 象 接口 定义 的 集中 存储 区 ， 可 以 用 
来 辅助 用 户 使 用 、 发 布 、 管 理 这 个 存储 区 中 记录 的 对 象 接口 。CORBA 是 分 布 计算 的 模型 ， 
所 以 这 里 所 说 的 存储 区 也 不 一 定 是 某 个 文件 或 某 个 数据 库 ， 它 也 是 分 布 的 ， 这 里 的 集中 存 
储 是 逻辑 上 的 存储 ， 具 体 的 存放 位 置 可 能 在 不 同 的 计算 机 上 。 

接口 仓库 要 实现 的 主要 功能 有 : 

口 为 不 同 ORB 之 间 的 互 操 作 提 供 实现 。 

口 供 ORB 用 来 检查 请 求 签 名 。 

口 供 ORB 检查 接口 之 间 大 继承 关系 。 

接口 仓库 提供 的 功能 及 工具 主要 依赖 于 CORBA 提供 商 ， 根 据 不 同 的 工具 ， 接 口 仓 库 
还 可 以 实现 更 多 的 功能 。 


名 注意 : ORB 是 对 象 请 求 代理 ( Object Request Broker ) 的 简写 ， 是 使 客户 应 用 程序 能 调用 
远 端 对 象 方法 的 一 种 机 制 。 


29.2.4 ”对 象 适配器 (Object Adapter，OA) 


对 象 适配器 是 ORB 的 一 部 分 ， 它 帮助 ORB 把 请 求 传 给 对 象 并 激活 该 对 象 ， 一 个 对 象 
适配器 只 能 与 一 个 对 象 实现 联系 ， 它 可 以 被 定义 来 支持 特定 的 对 象 实现 类 型 (如 OODB 对 
象 适配器 用 于 持续 对 象 ， 而 library 对 象 适配器 用 于 非 远程 对 象 ) 。 对 和 象 适配器 的 作用 主要 有 : 
产生 和 解释 对 象 引用 。 
方法 调用 。 
相互 作用 的 安全 性 。 

把 对 象 引 用 映射 到 相应 的 对 象 实现 。 
注册 对 象 实现 。 


OOOOODO 


29.2.5 “动态 调用 接口 (Dynamic Invocation Interface，DIl) 和 静态 
调用 接口 (Static Invocation Interface，SII) 


动态 调用 接口 和 静态 调用 接口 都 位 于 客户 端 ， 它 们 负责 发 送 客户 端的 调用 请 求 。 

在 客户 端 ，ORB 使 用 动态 调用 接口 (Dynamic Invocation Interface，DII) 来 发 送 操作 调 
用 ; 在 服务 器 端 ，OA 通过 动态 框架 接口 (Dynamic Skeleton Interface，DSI) 来 传输 一 个 操 
作 调 用 ， 它 是 服务 器 端 对 应 DII 的 行为 。 动 态 调用 接口 (DIT) 可 以 和 动态 骨架 接口 (DSI) 
结合 ， 使 得 客户 可 以 在 不 知道 服务 器 对 象 的 接口 的 情况 下 调用 服务 器 对 象 。 

在 客户 端 ,客户 与 ORB 之 间 的 静态 接口 被 称 为 静态 调用 接口 (Static Invocation Interface， 
SIT) ,在 服务 器 端 , 与 这 个 接口 对 应 的 被 称 为 静态 框架 接口 (Static Skeleton Interface，SSI) 。 
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29.2.6 GIOP 和 1IOP 


GIOP 是 一 种 通信 协议 ， 它 是 客户 方 的 ORB 和 服务 器 方 的 ORB 通信 的 协议 ， 它 规定 了 
客户 和 服务 器 ORBs 间 的 通信 机 制 。 

GIOP 是 CORBA 方法 调用 的 核心 部 分 。GIOP 不 基于 任何 特别 的 网 络 协议 ， 如 IPX 或 
TCP/IP。 为 了 确保 互 操作 性 , OMG 必须 将 GIOP 定义 在 所 有 供应 商都 支持 的 特定 传输 之 上 。 
因此 ，OMG 在 最 广泛 使 用 的 通信 传输 平台 一 一 TCP/IP 上 标准 化 GIOP。GIOP 加 TCP/IP 就 
是 IIOP。 


29.3 ”股票 查询 服务 一 CORBA 服务 实例 


29.3.1 使 用 IDL 语言 定义 IDL 接口 并 编译 映射 到 Java 程序 


这 是 开发 CORBA 应 用 程序 的 第 一 步 ， 接 口中 定义 了 客户 端 应 用 程序 可 以 访问 的 方法 ， 
但 没有 具体 的 实现 。 文 件 的 具体 内 容 如 下 文件 名 为 Stock.idl) : 


module StockApplication { 
interface StockOperation { 
void getStockName(in string StocklD,out string StockName); 
void getStockCurrentPrice(in string StocklD,out float currentprice); 
void getStockDiff(in string StocklD,out float diff); 


外 
» 
这 个 例子 是 要 实现 股票 的 查询 功能 ， 在 上 面 的 接口 中 定义 了 3 个 方法 ， 分 别 用 于 根据 
股票 代码 获取 股票 的 名 称 、 当 前 的 价格 和 浮动 状况 。 保 存 文件 到 src 文件 夹 后 ， 在 src 目录 
下 执行 : 


idlj -fall calculator.idl 
可 以 看 到 在 目录 下 生成 了 ArithApp 文件 夹 ， 下 面 有 6 个 文件 ， 分 别 如 下 : 
StockOperationPOA .Java 
StockOperationOperations.java 
StockOperationHolder.java 
StockOperationHelper.java 


OOOOCDO 


StockOperation .java 
DQ _StockOperationStub.java 

至 于 各 个 文件 的 作用 这 里 就 不 深入 介绍 了 ， 读 者 可 以 在 深入 学 习 CORBA 的 基础 上 了 
解 它们 的 用 途 。 
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29.3.2 ”实现 IDL 接口 


在 29.3.1 节 中 的 IDL 文件 中 定义 了 几 个 方法 ， 虽 然 也 生成 了 对 应 的 Java 文件 ， 但 并 没 
有 实际 执行 的 代码 ， 下 面 是 实现 这 个 接口 的 代码 : 


import org.omg.CORBA.IntHolder' 
import org.omg.CORBA.ORB; 
import org.omg.CORBA.*; 

import java.sql.*; 


import StockApplication.StockOperationPOA; 


public class StockQueryImpl extends StockOperationPOA { 

private ORB orb; 

private boolean connected = false; 

private String defaultSQLdriver = "com.mysql.jdbc.Driver"; 

private String defaultmySQLURL = "jdbc:mysql://localhost/StockBase?user=root&password 
=ict"; 

private Connection conn; 

public StockQueryImpl(ORB orb}{ 


this.orb =orb; 

H 

private void connectDB(String mySqlDriver,String SQLurl){ 
try{ 

// 加 载 数据 库 驱 动 程序 
Class.forName(mySqlDriver); 
}catch(Exception e){ 
System.out.printin("Driver Error"); 

b 

try{ 
// 与 数据 库 建立 连接 ， 得 到 Connection 的 对 象 
conn=DriverManager.getConnection(SQLur); 
connected = true; 
}catch(Exception e){ 
System.out.printin(" 无 法 连接 "); 
1 


public void getStockName(String StockID, StringHolder StockName){ 
if(!lconnected)f 
connectDB(defaultSQLdriver,defaultmySQLURL); 
try{ 
// 得 到 Statement 的 对 象 
Statement stmt=conn.createStatement(); 
ResultSet rs=null; 
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法 中 都 要 先 判断 是 否 具有 数据 库 连 接 ， 如 果 没 有 就 要 调用 connectDB 方法 连接 数据 库 : 
if(Iconnected){ 
connectDB(defaultSQLdriver,defaultmySQLURL); 
) 


各 注意 : 由 于 这 个 应 用 中 需要 连接 MySQL 数据 库 ， 需 要 把 数据 库 驱 动 程序 放 到 类 路 径 中 。 
29.3.3 ”编写 服务 端 实 现 


服务 器 端的 主要 功能 包括 : 

创建 并 初始 化 ORB 。 

创建 一 个 接口 实现 的 例子 ， 并 把 它 向 ORB 注册 。 
获得 RootPOA 的 引用 并 激活 POAManager。 

从 服务 中 得 到 对 象 的 引用 。 

从 命名 服务 中 获取 根 命名 上 下 文 并 把 这 个 新 对 象 注册 为 “Cal”。 
等 待 客户 端的 调用 。 

下 面 是 类 StockQueryServer 的 代码 : 

import org.omg.CORBA.ORB; 

import org.omg.CosNaming.NameComponent; 

import org.omg.CosNaming.NamingContextExt; 

import org.omg.CosNaming.NamingContextExtHelper; 


import org.omg.PortableServer.POA; 
import org.omg.PortableServer.POAHelper; 


DOOOODO 


import StockApplication.StockOperationPOA; 
import StockApplication.StockOperation; 
import StockApplication.StockOperationHelper'; 


public class StockQueryServer { 


public StockQueryServer() { 
super(); 


b 
public static void main(String args[]) { 


try{ 

// 创 建 并 初始 化 ORB 

ORB orb = ORB.init(args, null); 

// 创 建 一 个 接口 实现 的 例子 ， 并 把 它 向 ORB 注册 

StockQueryImpl impl = new StockQueryImpl(orb); 

// 获 得 RootPOA 的 引用 并 激活 POAManager 

POA rootpoa = POAHelper.narrow( 
orb.resolve_initial_references("RootPOA")); 

rootpoa.the_POAManager().activate(); 

/从 服务 中 得 到 对 象 的 引用 
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创建 并 初始 化 ORB。 
获得 根 命名 上 下 文 的 引用 。 
寻找 名 为 “Stock” 的 对 象 ， 并 获得 其 引用 。 
调用 接口 实现 中 实现 的 方法 。 


在 本 实例 中 ， 使 用 一 个 Servlet 首先 从 服务 器 端 获取 一 个 远程 对 象 ， 并 把 这 个 对 象 作为 
Application 范围 的 属性 , 在 其 他 页 面 需要 使 用 时 只 需要 从 JSP 的 application 隐 含 对 象 中 获取 
这 个 属性 就 可 以 了 ， 下 面 是 获取 远程 对 象 的 Servlet: 


package cn.ac.ict; 


import org.omg.CORBA.*; 

import org.omg.CosNaming.*; 

import StockApplication.StockOperation; 
import StockApplication.StockOperationHelper; 


import javax.servlet.http.*; 


public class StockQueryClientServlet extends HttpServlet { 


/or 
* 构造 方法 
SR 
public StockQueryClientServlet(){ 
super(); 


} 


public void init() { 
try{ 
String args[] = new String[2]; 
args[0] = "-ORBInitialPort"; 
args[1] = "3588"; 


// 创建 并 初始 化 ORB 
ORB orb = ORB.init(args, null); 
/ 获得 根 命名 上 下 文 
org.omg.CORBA.Object objRef = 
orb.resolve initial_references("NameService"); 
ll! Use NamingContextExt instead of NamingContext. This is 
/ll part of the Interoperable Naming Service. 
NamingContextExt ncRef = 
NamingContextExtHelper.narrow(objRef); 
/ 在 命名 服务 中 处 理 对 象 引 用 
String name = "Stock"; 
StockOperation impl = StockOperationHelper.narrow(ncRef.resolve str(name)); 
this.getServletContext().setAttribute("StockQuery",imp)); 


} catch (Exception e) { 
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StockOperation impl = (StockOperation)this.getServletContext().getAttribute 
("StockQuery"); 

StringHolder sname = new StringHolder(); 

FloatHolder currentprice = new FloatHolder(); 

FloatHolder diff = new FloatHolder(); 
// 调 用 查询 数据 的 方法 

impl.getStockName(SID,sname); 

impl.getStockCurrentPrice(SID,currentprice); 

impl.getStockDiff(SID,diff); 


out.write( "nn "); 

out.write("<table width=\"580\" border=\"0\" cellspacing=\"O\" cellpadding=\"O\" 
align=\"center\">\r\n"); 

out.write("<thead align=\"center\"> 查 询 结果 </thead>\mn"); 

out.write(” <tr>\An"); 

out.write(" ”<td> 股 票 代码 </td>\n\n"); 

out.write(” ”<td> 股 票 名 称 </td>\An"); 

out.write(" ”<td> 当 前 价格 </td>\n\n"); 

out.write(” ”<td> 浮 动 </td>\An"); 

out.write(” </tr>\n\n"); 

out.write(” <tr>\An"); 

out.write(" <td>"); 

out.print( SID ); 

out.write("</td>\A\n"); 

out.write(" <td>"); 

out.print( sname.value ); 

out.write("</td>\An"); 

out.write(" <td>"); 

out.print( currentprice.value ); 

out.write("</td>\A\n"); 

out.write(" <td>"); 

out.print( diff.value ); 

out.write("</td>\An"); 

out.write(” </tr>\r\n"); 

out.write("</table>\r\n"); 


out.write("\An"); 
out.write("</body>\r\n"); 
out.write("</html>\r\n"); 


} 

由 于 使 用 了 Servlet 获取 远程 对 象 和 调用 业务 方法 ， 就 需要 在 web.xml 文件 中 配置 这 些 
Servlet， 配 置 的 代码 将 在 29.3.6 节 介 绍 。 
29.3.6 配置 CORBA 服务 的 Servlet 客户 端 


配置 CORBA 服务 的 Servlet 客户 端 与 配置 普通 的 Servlet 没有 什么 区 别 , 在 发 布 描述 文 
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(4) 启动 Tomcat 服务 器 ， 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : 

http://localhost:8080/32/stockQuery.stockquery 

可 以 看 到 页 面 显 示 如 图 29.6 所 示 。 

如 果 查 询 了 数据 库 中 不 存在 的 股票 ， 就 会 显示 出 错误 的 股票 名 称 ， 一 个 简单 的 可 能 页 
面 如 图 29.7 所 示 。 而 输入 的 股票 代号 存在 时 就 会 显示 出 正确 的 信息 ， 页 面 效 果 如 图 29.8 
所 示 。 
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图 29.7 图 29.8 查询 结果 正确 显示 


查询 结果 出 现 错误 


29.4 小 结 


章 简单 介绍 了 在 分 布 式 计算 领域 得 到 广泛 应 用 的 CORBA 技术 。CORBA 是 支持 异 构 
分 布 应 用 程序 间 的 互 操 作 及 平台 无 关 的 ， 使 用 它 可 以 开发 性 能 良好 的 、 分 布 式 的 、 平 台 无 
关 的 应 用 程序 。 

本 章 先 通过 一 个 四 则 运算 的 例子 演示 了 CORBA 技术 与 Java 技术 的 结合 ， 然 后 解释 了 
CORBA 的 一 些 组 件 和 重要 概念 , 但 可 以 说 这 只 是 会 常常 遇 到 的 一 部 分 ,读者 要 掌握 CORBA 
还 需要 参考 更 多 的 资料 ， 在 最 后 一 节 演示 了 一 个 实际 使 用 CORBA 的 股票 查询 例子 ， 读 者 
应 该 对 照例 子 更 好 地 理解 如 何 使 用 CORBA。 
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Velocity 的 主要 用 途 就 是 简化 Web 应 用 的 开发 ， 是 一 个 功能 强大 的 模板 工具 。 在 本 章 
中 将 会 通过 一 个 简单 的 例子 首先 告诉 读者 如 何 使 用 这 个 模板 工具 ， 之 后 会 介绍 Velocity 模 
板 语言 的 相关 知识 。 


30.1 Velocity 入 门 


30.1.1 简介 


Velocity 是 一 个 基于 Java 的 模版 引擎 ， 是 Apache 软件 组 织 提供 的 一 项 开放 源 代 码 的 项 
目 。 它 允许 Web 页 面 设计 者 通过 Velocity 模板 语言 定义 模板 , 在 模板 中 不 需要 加 入 任何 Java 
代码 ， 由 Java 开发 者 编写 程序 来 设置 上 下 文 〈 包 含 用 户 替 换 模板 中 某 个 代码 的 数据 ) ， 
Velocity 引擎 就 可 以 把 模板 和 上 下 文 结合 起 来 生成 动态 的 网 页 。 这 样 Web 设计 者 可 以 根据 
MVC 模式 和 Java 程序 员 并 行 工作 ，Web 设计 者 可 以 单独 专注 于 设计 良好 的 站 点 ， 而 程序 
员 则 可 单独 专注 于 编写 底层 代码 。Velocity 将 Java 代码 从 Web 页 面 中 分 离 出 来 , 使 站 点 在 
长 时 间 运 行 后 仍然 具有 很 好 的 可 维护 性 ， 并 提供 了 一 个 除 JSP 和 PHP 之 外 的 可 行 的 被 选 方案 。 

Velocity 模板 语言 (VTL) 为 网 页 开发 者 提供 了 简捷 的 方法 来 生成 动态 网 页 。 即 使 没有 
编程 经 验 的 人 也 可 以 很 快 地 掌握 VTL 语言 。VTL 模板 中 不 包含 任何 Java 代码 ， 是 其 与 JSP 
网 页 的 一 个 重要 区 别 ， 而 且 VTL 模板 不 需要 经 过 JSP 编译 器 的 编译 ，VTL 模板 的 解析 是 由 
Velocity 完成 的 。 

Velocity 可 用 来 从 模板 产生 Web 页 面 、SQL、PostScript 以 及 其 他 输出 。 也 可 用 于 一 个 
独立 的 程序 以 产生 源 代码 和 报告 ， 或 者 作为 其 他 系统 的 一 个 集成 组 件 ， 不 过 它 的 主要 用 途 
还 是 简化 Web 开发 。 

下 面 运行 一 个 简单 的 Velocity 例子 ， 了 解 开发 基于 Velocity 的 程序 需要 的 必要 步骤 。 


30.1.2 ”安装 Velocity 


从 Velocity 的 主页 (http://jakarta.apache.org/velocity/index.html) 上 下 载 Velocity-1.4 版 
本 (velocity-1.4.zip》。 把 这 个 压缩 文件 解压 缩 ， 在 解压 的 目录 下 可 以 看 到 两 个 JAR 文件 : 
velocity-1.4.jar 和 velocity-dep-1.4.jar。 这 就 是 开发 基于 Velocity 的 程序 需要 的 最 关键 的 两 个 
JAR 文件 ,只 要 把 这 两 个 JAR 文件 复制 到 Web 应 用 程序 的 WEB-INF 目录 下 的 lib 文件 夹 下 
就 可 以 完成 安装 了 。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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if(path==nuIl){ 
System.out.printin("HelloVelocity.loadConfiguration():"+ 
"unable to get the current webapp root. Using /. "); 
path="/"; 


} 

// 设 置 属性 
p.setProperty(Velocity.FILE_RESOURCE_LOADER_PATH,path); 
p.setProperty("runtime.log",path+"velocity.log ); 


return p; 


} 
// 对 客户 请 求 进行 处 理 ， 把 模板 中 的 变量 替换 为 动态 数据 
public Template handleRequest(HttpServletRequest request, HttpServletResponse response, 
Context context){ 
Template outty=null; 
try{ 
String username = "rambler"; 
Date today = new Date(); 
// 把 模板 中 的 变量 替换 为 动态 数据 
context.put("name",username); 
context.put("date",today.toString()); 
outty=getTemplate("hellovelocity.vm"); 
}catch(ParseErrorException ex1}{ 
System.out.printin("HelloVelocity: parse error for template "+ex1); 
}catch(ResourceNotFoundException ex2){ 
System.out.println("HelloVelocity: template not found "+ex2); 


}catch(Exception ex3){ 
System.out.println("HelloVelocity: error "+ex3); 
lL 
return outty; 


} 
1 
在 HelloVelocity.java 中 对 VelocityServlet 的 两 个 重要 方法 进行 了 重 写 , 下 面 分 别 介绍 它 
们 完成 的 工作 : 

口 loadConfiguration() 方 法 是 VelocityServlet 的 初始 化 方法 ， 它 由 VelocityServlet.init() 
调用 , 并 设置 模板 所 在 的 路 径 , 默认 情况 下 就 是 Web 应 用 的 根 目 录 , 如 果 使 用 WAR 
文件 发 布 应 用 在 Tomcat 上 仍然 可 以 运行 。 

口 handleRequest( 方 法 是 用 于 提供 服务 的 方法 ， 也 就 是 完成 从 模板 生成 动态 网 页 的 过 
程 ， 它 由 VelocityServlet 自动 调用 。 

在 HelloVelocity 的 handleRequest 方法 中 指定 了 用 户 的 名 字 为 “rambler”， 并 生成 了 一 

个 日 期 对 象 ， 然 后 对 模板 上 下 文中 的 变量 name 和 date 进行 了 蔡 换 : 
String username = "rambler ; 
Date today = new Date(); 


context.put("name",username); 
context.put("date",today.toString()); 
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最 后 它 获 得 模板 ， 并 返回 代表 hellovelocity.vm 模板 的 对 象 : 
outty=getTemplate("hellovelocity.vm"); 


return outty; 
3. 配置 HelloVelocity 
要 使 得 应 用 能 够 识别 这 个 Servlet， 需 要 在 web.xml 文件 中 添加 如 下 元 素 : 


<Servlet> 
<Servlet-name>hello</servlet-name> 
<Servlet-class>cn.ac.ict.HelloVelocity</servlet-class> 
</servlet> 


<servlet-mapping> 
<servlet-name>hello</servlet-name> 
<url-pattern>/hello</url-pattern> 
</servlet-mapping> 


4. 发 布 基 于 Velocity 的 Web 应 用 

上 面 的 这 个 应 用 完成 之 后 其 程序 的 结构 如 图 30.1 所 示 。 

也 可 以 按照 如 下 步骤 发 布 这 个 应 用 : 
(1) 编译 HelloVelocityjava， 需 要 把 servelet-api.jar 和 velocity-1.4.jar 文件 放 到 类 路 径 中 。 
(2) 把 编译 生成 的 类 文件 复制 到 Web 应 用 的 WEB-INF\classes\cn\ac\ict 目录 下 。 

(3) 把 hellovelocity.vm 文件 放 到 Web 应 用 的 根 目录 下 。 

(4) 把 velocity-dep-1.4.jar 文件 和 velocity-1.4.jar 文件 复制 到 WEB-INF\lib 目录 下 。 
(5) 启动 Tomcat， 然 后 在 浏览 器 地 址 栏 中 输入 如 下 地 址 : http://localhost:8080/velocity/ 


hello， 可 以 看 到 页 面 显 示 如 图 30.2 所 示 。 
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图 30.1 基于 Velocity 的 Web 应 用 的 程序 结构 图 30.2 基于 Velocity 的 Web 应 用 效果 


30.2 注 释 


VTL 支持 单行 注释 〈 以 扒 开 始 ) 和 多 行 注释 (包括 在 礁 和 准 之 间 )。 例 如 : 


## This is a single line comment. 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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30.3.2 属性 引用 


属性 应 用 的 使 用 格式 是 : SVTL 标识 符 . VTL 标识 符 。 

下 面 是 属性 引用 的 例子 : 

$customer.Address 

$purchase.Total 

第 一 个 引用 $customer.Address 可 以 看 作 名 为 customer 的 Hashtable 对 象 中 键 值 为 Address 
的 值 ， 也 可 以 看 作 是 一 个 方法 : $customer.getAddress()。 属 性 引用 可 以 有 两 种 解释 方式 ， 
Velocity 会 根据 开发 者 编写 的 程序 在 运行 时 决定 如 何 解释 。 那 什么 时 候 按 方法 解释 ， 什 么 时 
候 按照 Hashtable 对 象 解释 呢 ? 

其 实 属性 引用 的 两 种 解释 方式 对 应 了 其 两 种 赋值 方式 ， 当 属性 引用 使 用 Hashtable 对 象 
赋值 时 就 会 按照 Hashtable 对 象 的 方式 解释 ， 当 属性 引用 在 JavaBeans 中 使 用 某 个 方法 赋值 
时 就 需要 被 解释 成 方法 。 下 面 分 别 举例 说 明 。 

1. 使 用 Hashtable 对 象 赋值 

使 用 Hashtable 对 象 赋值 , Velocity 引擎 就 会 把 属性 引用 按照 Hashtable 对 象 的 键 值 引用 ， 

下 面 是 一 个 使 用 Hashtable 对 象 赋值 的 例子 。 

Velocity 模板 如 下 : 

<html> 

<title>Hello Velocity</title> 

<body> 

<h3>Product Info are listed below:</h3><br/> 

<p>Product Name:$product.name </p><br/> 


<p>Product Price:$product.price © </p><br/> 
<p>Product Company:$product.comp </p> <br/> 


</body> 
</html> 


对 应 的 VelocityServlet 如 下 : 


package cn.ac.ict; 


import java.io.*; 

import java.util.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 

import org.apache.velocity.*; 

import org.apache.velocity.context.*; 
import org.apache.velocity.servlet.*; 
import org.apache.velocity.app.*; 
import org.apache.velocity.exception.*; 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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<servlet-name>product_1</servlet-name> 
<url-pattern>/product_1</url-pattern> 


</servlet-mapping> 
然后 把 编译 后 的 类 文件 复制 到 
器 地 址 栏 中 输入 : http://localhost:80 
_1， 可 以 看 到 这 时 的 页 面 显 示 如 图 


2. 在 JavaBeans 中 用 方法 赋值 


WEB-INF\classes\cn\ac\ict 目录 下 ， 启 动 Tomcat， 在 浏览 
80/velocity/product 
30.3 所 示 。 


Product Info are listed below: 


当 属 性 引用 在 JavaBeans 中 使 
就 


package cn.ac.ict; 


import java.io.”; 

import java.util.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 
import org.apache.velocity.”; 


和 要 被 解释 成 方法 。 下 面 是 一 个 使 用 JavaBeans 中 
用 方法 赋值 的 例子 ， 其 中 模板 仍然 使 用 上 面 的 模板 ， ee 
下 面 是 对 应 的 VelocityServlet 的 源 代码 : _ 四 


用 某 个 方法 赋值 时 


Product llane:cel] shore 


[BE I EE 


图 30.3 属性 引用 的 效果 


import org.apache.velocity.context.*; 


import org.apache.velocity.servlet 
import org.apache.velocity.app.”; 


二 


import org.apache.velocity.exception.*; 


public class ProductVelocity_2 extends VelocityServlet{ 


// 加 载 配置 信息 


protected Properties loadConfiguration(ServletConfig config) 
throws IOException,FileNotFoundException{ 
Properties p=new Properties(); 
String path=config.getServletContext().getRealPath("/"); 


i 放 path==null){ 


System.out.printlin("ProductVelocity.loadConfiguration():"+ 
"unable to get the current webapp root. Using /. "); 


path="/"; 


} 
1/ 设置 属性 


p.setProperty(Velocity.FILE_RESOURCE_LOADER_PATH,path); 


p.setProperty("runtime. 


return p; 


log",path+"velocity.log"); 


} 
// 对 客户 请 求 进行 处 理 ， 把 模板 中 的 变量 替换 为 动态 数据 
public Template handleRequest(HttpServletRequest request, HttpServletResponse response, 


Context context){ 
Template outty=null; 


try{ 
// 把 模板 中 的 变量 替换 为 动态 数据 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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30.3.4 正式 引用 符 (Formal Reference Notation ) 


在 上 面 几 节 中 讲述 的 都 是 引用 符 的 简略 形式 ， 除 了 上 面 介绍 的 引用 符 ， 还 有 一 种 正式 引 
用 符 ， 它 比 简略 形式 的 引用 在 标识 符 外 多 了 一 个 括号 ， 例 如 下 面 的 例子 都 是 正式 的 应 用 符 : 


${mudSlinger} 
S${customer.Address} 
S${purchase.getTotal()} 


其 实 简 略 形式 的 引用 符 和 正式 引用 符 效果 是 一 样 的 ， 所 以 一 般 情 况 下 都 使 用 简略 引用 
符 ， 不 过 在 一 些 情况 下 就 必须 使 用 正式 引用 符 以 区 分 引用 符 和 普通 的 字符 串 。 例 如 : 

Jack is a $vicemaniac 

如 果 刚 好 有 一 个 名 为 vice 的 变量 ， 上 面 的 代码 解释 起 来 就 会 出 现 问题 ， 是 应 该 把 
vicemaniac 作为 引用 的 标识 符 还 是 把 vice 作为 标识 符 呢 ? 为 了 避免 系统 运行 的 这 种 不 确定 
性 ， 就 可 以 使 用 正式 引用 符 来 避免 问题 的 发 生 ， 例 如 ， 上 面 的 例子 ， 实 际 上 要 引用 名 为 vice 
的 变量 ， 为 了 避免 误解 ， 就 可 以 像 下 面 这样 写 : 

Jack is a ${vice}maniac 

这 样 Velocity 就 会 知道 是 把 vice 作为 变量 进行 引用 , 而 不 会 去 引用 vicemaniac, 避免 了 

误 的 发 生 。 


30.3.5 “安静 引用 符 (Quiet Reference Notation ) 


下 面 的 例子 : 

<input type="text" name="email" value="$email"/> 

a, Semail 没有 值 ， 所 以 文本 框 中 会 显示 值 Semail， 但 实际 应 用 中 它 显示 空白 更 合 
适 一 些 ， 而 不 是 这 样 一 个 客户 无 法 识别 的 符号 。 要 解决 这 个 问题 ， 就 可 以 使 用 安静 引用 符 
来 避 rt 可 以 按照 如 下 方式 修改 ; 

<input type="text" name="email" value="$lemail"/> 

可 见 安静 引用 符 就 是 比 常 规 引 用 符 在 $ 后 多 了 一 个 !。 这 样 ， 如 果 变 量 email 没有 值 ， 文 
本 框 中 会 显示 空白 ， 而 不 是 Semail 了 。 

正式 引用 符 可 以 和 安静 引用 符 一 起 使 用 ， 如 下 : 


<input type="text" name="email" value="$!{email}"/> 


30.4 指 令 


模板 设计 者 可 以 使 用 上 面 介绍 的 引用 输出 动态 网 页 的 内 容 ， 可 以 使 用 指令 操纵 Java 代 
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码 的 输出 ， 从 而 控制 页 面 的 外 观 和 内 容 。Velocity 提供 了 丰富 的 Java 代码 操作 指令 ， 下 面 
分 别 介绍 各 个 指令 的 作用 和 使 用 方法 。 


30.4.1 #set 指令 一 一 变量 赋值 

格式 : #set( LHS =RHS )。 

口 LHS 可 以 是 变量 引用 或 属性 引用 。 

口 RHS 可 以 是 引用 、 字 符 串 、 数 字 、ArrayList 或 Map。 

#set 指令 用 来 为 应 用 变量 和 引用 属性 赋值 ， 下 面 是 一 些 使 用 #set 指令 的 正确 例子 : 


#set( $primate = "monkey" ) 

#set( $customer.Behavior = $primate ) 

#set( $monkey = $bill ) ## variable reference 

#set( $monkey.Friend = "monica" ) ## string literal 

#set( $monkey.Blame = $whitehouse.Leak ) ## property reference 
#set( $monkey.Plan = $spindoctor.weave($web) ) ## method reference 
#set( $monkey.Number = 123 ) ##number literal 

#set( $monkey.Say = ["Not", $my, "fault"] ) ## ArrayList 


在 上 面 的 例子 中 演示 了 把 允许 的 数据 类 型 赋值 给 引用 的 例子 。 对 于 ArrayList 和 Map， 
可 以 使 用 对 应 的 Java 方法 访问 其 中 的 元 素 值 : 
$monkey.Say.get(0) 


$monkey.Map.get("bannana") 
$monkey.Map.banana ## same as above 


RHS 可 以 是 简单 的 算术 表达 式 ， 例 如 : 
#set( $value = $foo + 1 ) ## Addition 

#set( $value = $bar - 1 ) 此 Subtraction 
#set( $value = $foo * $bar ) ## Multiplication 


#set( $value = $foo / $bar ) 夫 Division 
#set( $value = $foo % $bar ) ## Remainder 


全 注意 : (1) 算术 表达 式 只 支持 整 型 。/ 的 结果 为 整数 ; 如 果 为 非 整 型 数值 ， 返 回 null。 
(2) 如 果 RHS 的 结果 为 null， 是 不 会 赋值 给 LHS 的 。 
看 下 面 的 例子 : 
#set( $criteria = ["name", "address"] ) 
#foreach( $criterion in $criteria ) 
#set( $result = $query.criteria($criterion) ) 
#if( $result ) 
Query was successful 
#end 
#end 
上 面 使 用 $result 检查 是 否 执行 成 功 是 有 问题 的 。 如 果 第 一 次 执行 成 功 ，Sresult 不 为 null， 
则 后 面 的 执行 不 论 是 否 成 功 , 检查 条 件 总 是 成 立 。 改进 的 方法 是 在 每 次 执行 前 初始 化 为 false: 
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#set( $criteria = ["name", "address"] ) 
#foreach( $criterion in $criteria ) 
#set( $result = false ) 
#set( $result = $query.criteria($criterion) ) 
#if( $result ) 
Query was successful 
#end 
#end 


全 注意 :' 上 例 中 使 用 了 一 些 尚未 介绍 的 指令 ， 读 者 可 以 参考 后 面 几 节 的 介绍 。 

String 文字 可 以 使 用 双 引 号 或 单 引 号 括 起 来 。 两 者 的 主要 区 别 是 双 引 号 中 的 引用 会 奉 换 
成 相应 的 值 ， 而 单 引号 中 的 引用 原样 输出 。 

#set( $directoryRoot = "www" ) 

#set( $templateName = "index.vm" ) 


#set( $template = "$directoryRoot/$templateName" ) 
$template 


输出 结果 是 : 

wwwlindex.vm 

如 果 使 用 单 引 号 : 

#set( $template = '$directoryRoot/$templateName ) 
输出 结果 是 : 

$directoryRoot/$templateName 

使 用 双 引号 可 以 实现 字符 串 的 串联 ， 如 下 面 的 例子 : 


#set( $size = "Big" ) 
#set( $name = "Ben" ) 
#set($clock = "${size}Tall$name" ) 
The clock is $clock. 


30.4.2 ”#if 央 elseif/#else 指令 一 一 条 件 语 句 

Velocity 的 #if 指令 在 条 件 成 立时 ， 显 示 #if 和 #end 之 间 的 内 容 ， 和 否则 显示 #else 和 #end 
之 间 的 内 容 。 下 面 是 一 个 例子 : 

#if( $foo ) 

<strong>Velocity!</strong> 

#end 

Velocity 会 先 对 变量 $foo 求 值 ， 确 定 条 件 是 否 成 立 ， 条 件 成 立 的 条 件 有 两 个 : 
口 如 果 $foo 是 boolean， 则 $foo 要 为 true。 
口 否则 ，S$foo 不 为 null。 
而 条 件 不 成 立 的 条 件 就 是 上 面 的 对 立 面 了 : 
口 $foo 是 boolean， 并 日 $foo 值 是 false。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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#foreach( $customer in $customerList ) 
<tr><td>$velocityCount</td><td>$customer.Name</td></tr> 

#end 

</table> 


循环 次 数 的 默认 变量 的 名 称 和 初始 值 都 保存 在 velocity.properties 文件 中 ， 默 认 是 
S$velocityCount， 默 认 初 始 值 是 1， 可 以 修改 这 个 文件 ， 使 其 为 0 或 者 1， 以 适应 不 同人 的 编 
程 习惯 。velocity.properties 文件 的 定义 如 下 : 


# Default name of the loop counter 
# variable reference. 
directive.foreach.counter.name = velocityCount 


# Default starting value of the loop 
# counter variable reference. 
directive.foreach.counter.initial.value = 1 


下 面 举 一 个 使 用 #foreach 指令 的 例子 ， 它 把 一 个 Hashtable 中 所 有 的 对 象 信息 输出 ， 这 
个 例子 使 用 的 模板 products.vm 如 下 : 


<html> 

<title>Hello Velocity</title> 
<body> 

<h3>All Product Info are listed below:</h3><br/> 
<table border=1> 

<tr> 

<td>Name</td> 

<td>Price</td> 
<td>Company</td> 

</tr> 

#foreach($product in $productlist) 
<tr> 

<td>$product.name </td> 
<td>$product.price</td> 
<td>$product.comp </td> 

</tr> 

#end 


</table> 


</body> 
</html> 


对 应 的 VelocityServlet 的 源 代码 如 下 : 


package cn.ac.ict; 


二 


import java.io. 
import java.util.*; 
import javax.servlet*; 

import javax.servlet.http.*; 
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import org.apache.velocity.*; 

import org.apache.velocity.context.*; 
import org.apache.velocity.servlet.*; 
import org.apache.velocity.app.”; 
import org.apache.velocity.exception.”; 


public class ProductsVelocity extends VelocityServlet{ 
// 加 载 配 置信 息 
protected Properties loadConfiguration(ServletConfig config) 
throws IOException,FileNotFoundException{ 
Properties p=new Properties(); 
String path=config.getServletContext().getRealPath("/"); 
读 path==null){ 
System.out.println("ProductVelocity.loadConfiguration():"+ 
"unable to get the current webapp root. Using /. "); 
path="/"; 
} 
p.setProperty(Velocity.FILE_RESOURCE_LOADER_PATH,path); 
p.setProperty("runtime.log",path+"velocity.log"); 


return p; 


| 
// 对 客户 请 求 进行 处 理 ， 把 模板 中 的 变量 替换 为 动态 数据 
public Template handleRequest(HttpServletRequest request，HttpServletResponse response, 
Context context){ 
Template outty=null; 
try{ 
Hashtable productlist = new Hashtable(); 
Product product = new Product(); 
product.setName("cell phone"); 
product.setPrice("899.99"); 
product.setComp("Haier ); 
productlist.put(product.getName(),product); 


product = new Product(); 
product.setName("air conditioning ); 
product.setPrice("8899.99"); 
product.setComp("Haier"); 
productlist.put(product.getName(),product); 


product = new Product(); 
product.setName("clock"); 
product.setPrice("99.99"); 
product.setComp("Haier ); 
productlist.put(product.getName(),product); 


context.put("productlist",productlist); 
outty=getTemplate("products.vm"); 
}catch(ParseErrorException ex1){ 
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System.out.println("ProductVelocity: parse error for template "+ex1); 
}catch(ResourceNotFoundException ex2){ 
System.out.println("ProductVelocity: template not found "+ex2); 


}catch(Exception ex3){ 
System.out.println("ProductVelocity: error "+ex3); 
} 
return outty; 


} 
} 
在 这 个 VelocityServlet 中 建立 一 个 Hashtable 对 象 ,， 并 向 其 中 添加 3 个 Product 对 象 , 这 


样 ， 在 页 面 中 就 可 以 循环 这 个 Hashtable 对 象 中 所 有 的 对 象 ， 然 后 输出 各 个 对 象 的 信息 。 下 
面 是 所 使 用 的 JavaBeans 类 Productjava 的 源 代码 : 


package cn.ac.ict; 
public class Product { 

private String name; 

private String price; 

private String comp; 

// 下 面 是 各 个 属性 的 设置 方法 

public void setName(String nn){ 
name = Nn; 

public void setPrice(String ppif 
price = pp; 

} 

public void setComp(String ccX{ 
comp = cc; 


} 
/下 面 是 各 个 属性 的 获取 方法 
public String getName(){ 
return name; 
public String getPrice(){ 
return price ; 
} 
public String getComp(X{ 
return comp; 
b 
} 


把 上 面 的 文件 编译 ， 按 照 上 面 介绍 的 方法 发 布 ， 注 


<Servlet> 
<Sservlet-name>products</servletname> 
<Servlet-class>cn.ac.ict.ProductsVelocity</servlet-class> 
</servlet> 


在 web.xml 文件 中 添加 如 下 元 素 : 


<Servlet-mapping> 
<servlet-name>products</servlet-name> 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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#parse 指令 与 #include 指令 的 区 别 就 在 于 #include 指令 只 是 把 文件 包含 到 指令 所 在 的 位 
置 ， 而 #parse 指令 是 把 被 包含 文件 解析 后 的 结果 包含 到 指令 所 在 的 地 方 。 


30.4.6 ”#stop 指令 一 一 停止 模板 执行 


#stop 指令 使 得 设计 者 可 以 中 止 模板 的 执行 并 返回 ， 这 对 于 调试 来 说 是 很 有 用 的 。 


30.4.7 _#macro 指令 一 一 定义 VTL 模板 
#macro 指令 允许 定义 一 段 重 复 使 用 的 VTL 模板 〈 称 为 Veloci macros) 。Velocimacros 
可 以 有 0 或 多 个 参数 。 下 面 是 一 个 例子 : 
#macro( tablerows $color $somelist ) 
#foreach( $something in $somelist ) 
<tr><td bgcolor=$color>$something</td></tr> 
#end 
#end 
这 个 称 为 tablerows 的 Velocimacros 带 两 个 参数 : color (Scolor) 和 array ($somelist) 。 
下 面 的 代码 包含 对 tablerows 的 调用 : 
#set( $greatlakes = ["Superior","Michigan","Huron","Erie","Ontario"] ) 
#set( $color = "blue" ) 
<table> 
#tablerows( $color $greatlakes ) 
</table> 
输出 结 果 为 : 
<table> 
<tr><td bgcolor="blue">Superior</td></tr> 
<tr><td bgcolor="blue">Michigan</td></tr> 
<tr><td bgcolor="blue">Huron</td></tr> 
<tr><td bgcolor="blue">Erie</td></tr> 
<tr><td bgcolor="blue">Ontario</td></tr> 
</table> 
Velocimacros 可 以 在 VTL 模板 中 定义 为 inline， 这 样 对 其 他 的 VTL 模板 是 无 效 的 ， 要 
使 Velocimacros 在 所 有 VTL 模板 中 共享 , 可 以 将 Velocimacros 定义 在 Velocimacros 模板 库 
(全 局 ) 中 。 
Velocimacros 属性 在 velocity.properties 文件 中 定义 ， 提 供 实现 Velocimacros 的 灵活 性 : 
DQ velocimacro.library = VM_ global library.vm 。 
velocimacro.permissions.allow.inline = true。 
velocimacro.permissions.allow.inline.to.replace.global = false。 


velocimacro.permissions.allow.inline.local.scope = false。 


DODOO 


velocimacro.context.localscope = false。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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30.5 ”VTL 的 其 他 特征 


30.5.1 关系 运算 和 逻辑 运算 


Velocity 使 用 “三 ”判断 两 个 变量 是 否 相 等 ， 下 面 是 一 个 演示 等 号 运算 符 如 何 使 用 的 例子 : 


#set ($foo = "deoxyribonucleic acid") 
#set ($bar = "ribonucleic acid") 


#if ($foo == $bar) 
In this case it's clear they aren't equivalent. So... 
#else 
They are not equivalent and this will be the output. 
#end 
这 时 ，S$foo 和 $bar 是 不 相等 的 ， 输 出 的 结果 是 : 
They are not equivalent and this will be the output. 
Velocity 也 有 AND、OR 和 NOT 运算 符 ， 其 中 AND 使 用 的 符号 是 &&， 下 面 是 一 个 使 
用 逻辑 与 的 例子 : 
## logical AND 


#if( $foo && $bar ) 
<strong> This AND that</strong> 

#end 

#if 指令 的 条 件 只 有 在 $foo 和 S$bar 都 为 true 的 情况 下 才 返 回 true， 如 果 $foo 为 false， 
Velocity 引擎 将 不 会 继续 求 Sbar 值 , 因为 任何 一 个 为 false, 表达 式 为 false; 如 果 $foo 为 true， 
才 会 继续 求 Sbar 的 值 。 

逻辑 OR 的 操作 是 类 似 的 ， 它 使 用 的 符号 是 |， 下 面 是 一 个 使 用 逻辑 或 的 例子 : 

# logical OR 


#if( $foo || $bar ) 
<strong>This OR That</strong> 
#end 


如 果 $foo 为 true，Velocity 引擎 将 不 会 继续 求 Sbar 值 ， 而 直接 设置 表达 式 为 rue， 届 辑 


NOT 的 符号 是 ! ， 它 只 有 一 个 参数 ， 下 面 是 一 个 逻辑 非 的 例子 。 
##logical NOT 


#if( !$foo ) 
<strong>NOT that</strong> 
#end 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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这 里 的 m 和 n 都 必须 是 整数 。 m 和 nm 的 大 小 没有 限制 ， 如 果 n 大 于 mm， 计数 从 大 到 小 ; 
如 果 n 小 于 m， 计 数 从 小 到 大 。 下 面 举 几 个 范围 操作 的 例子 : 
第 1 个 例子 : 


#foreach( $foo in [1..5] ) 
$foo 
#end 


上 面 的 代码 输出 : 
ma 
第 2 个 例子 : 


#foreach( $bar in [2..-2] ) 
$bar 
#end 


这 个 例子 的 输出 结果 是 : 
210-1-2 

第 3 个 例子 : 

#set( $arr = [0..1] ) 
#foreach( $i in $arr ) 


$i 
#end 


这 个 例子 的 输出 结果 是 : 
01 

第 4 个 例子 : 

[1..3] 

这 个 例子 的 输出 结果 是 : 
[1..3] 


30.6 人 小 结 


Velocity 是 一 个 基于 Java 的 模版 引擎 。 它 使 用 模板 生成 动态 网 页 ,并 可 以 作为 WebWork 
的 视图 组 件 ， 其 使 用 者 越 来 越 多 。 创 建 基 于 Velocity 的 Web 应 用 包括 两 个 步骤 : 
口 创建 模板 。 
口 创建 扩展 VelocityServlet 的 Servlet 类 。 

在 本 章 中 介绍 了 Velocity 的 大 量 基础 知识 ， 还 举 了 大 量 的 例子 来 讲述 各 个 指令 或 者 语 
法 的 工作 过 程 , 读者 可 以 重点 学 习 Velocity 的 基础 知识 , 之 后 就 会 发 现 把 Velocity 和 Tomcat 
结合 不 是 件 难事 了 。 


加 载 中 


请 耐心 等 待 或 者 刷新 重 试 
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本 章 继续 介绍 一 个 实际 应 用 的 例子 。 这 是 一 个 简单 的 在 线 图 书 定购 系统 ， 它 使 用 了 
JavaBeans、JDBC 数据 库 连 接 等 技术 。 通过 这 个 例子 , 读者 应 该 能 够 很 好 地 理解 很 多 商业 应 
用 的 设计 ， 对 以 后 从 事 开 发 工作 是 很 有 意义 的 。 


31.1 BookStore 实例 介绍 


31.1.1 BookStore 的 结构 描述 


这 个 Web 应 用 由 3 个 JavaBeans、5 个 JSP 页 面 和 1 个 工具 类 构成 。 其 中 各 个 构成 元 素 
的 作用 如 下 : 

(1) 商品 基本 信息 的 JavaBeans 一 一 Book， 这 个 JavaBeans 用 于 保存 图 书 的 基本 信息 ， 
如 书 名 、 价 格 、 出 版 社 等 信息 。 

(2) 购物 车 Bean 一 一 BookShopCart， 这 个 JavaBeans 用 于 模仿 一 个 购物 车 ， 在 这 个 购 
物 车 中 可 以 加 入 很 多 的 图 书 项 目 。 

(3) 购买 项 目 Bean 一 一 ShopBookItem， 这 个 JavaBeans 表示 一 个 购买 项 目 ， 这 个 购买 
项 目 是 指 多 个 同一 图 书 。 例 如 客户 购买 了 10 本 《Tomcat Web 开发 及 整合 应 用 》， 则 这 10 
本 书 就 构成 了 一 个 购买 项 目 ， 购 买 项 目 封装 了 图 书 的 信息 和 图 书 的 数量 信息 。 

(4) 数据 库 连接 初始 化 一 一 initjsp， 这 个 JSP 文件 用 于 获取 数据 库 连 接 ， 它 没有 任何 
显示 任务 ， 任 何 需要 数据 库 连 接 的 页 面 都 必须 包含 这 个 文件 。 

(5) 图 书 列表 页 面 一 listjsp， 这 个 JSP 页 面 用 于 列 出 所 有 客户 可 以 购买 的 图 书信 息 ， 
读者 在 这 个 页 面 中 可 以 选择 某 个 图 书 将 其 加 入 到 购物 车 中 。 

(6) 添加 图 书 确认 页 面 一 一 add.jsp， 这 个 JSP 页 面 用 于 显示 客户 想 要 加 入 购物 车 的 图 
书信 息 ， 在 这 个 页 面 中 ， 客 户 可 以 修改 购买 的 数量 ， 并 提交 把 图 书 加 入 到 购物 车 中 。 

(7) 中 转 页 面 一 一 putintocartjsp， 这 个 JSP 页 面 没 有 显示 任务 ， 它 的 功能 就 是 获得 客 
户 要 购买 的 某 种 商品 的 详细 信息 ， 并 把 商品 的 详细 信息 封装 成 Book 对 象 ， 把 图 书信 息 对 象 
保存 到 Session 中 ， 最 后 把 客户 请 求 转发 到 添加 图 书 确认 页 面 。 

(8) 查看 购物 车 一 一 showcart.jsp， 这 个 JSP 页面 用 于 显示 客户 的 购物 车 中 的 内 容 ， 并 
根据 购物 车 的 不 同 状态 ， 显 示 不 同 的 信息 。 
(9) 工具 类 一 一 ShopUtiljava， 这 个 工具 类 被 设计 成 提供 一 些 有 用 的 功能 。 在 本 实例 
中 它 只 有 一 个 方法 ， 用 于 转换 字符 的 编码 方式 ， 以 支持 显示 中 文 。 
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31.1.2 “BookStore 的 功能 介绍 


在 了 解 了 BookStore 的 结构 后 , 下 面 介绍 一 下 BookStore 的 功能 。 它 的 功能 可 以 通过 图 31.1 


init | min | 


es 
| aadisp | | aadisp | 


修改 数量 并 
确认 购买 -了 


添加 到 
购物 车 
1 


| 
BookShopCart [-------- ShopBookltem gr------------ 


图 31.1 ShopOnLine 的 功能 介绍 

客户 访问 这 个 Web 应 用 的 过 程 如 下 : 

(1) 客户 登录 这 个 Web 应 用 后 ， Cn listjsp 页 面 ， 这 个 页 面包 含 了 initjsp， 连 接 
数据 库 ， 获 得 所 有 图 书信 息 并 在 页 面 上 显 

(2) 在 listjsp 页 面 中 ， pope 车 链接 后 ， 转 入 putintocart. 
jsp 页 面 ， 在 这 个 页 面 中 根据 图 书 的 ID 获取 图 书 的 全 部 信息 ， 并 构造 一 个 Book 对 象 ， 并 把 
它 保存 为 Session 范围 的 属性 ， 然 后 把 请 求 转 发 到 add.jsp。 

(3) 在 addjsp 页 面 中 显示 客户 刚刚 选中 的 图 书信 息 , 客户 修改 购买 的 数量 后 提交 给 自 
身 页 面 。 

(4) 此 时 的 页 面 传送 了 一 个 名 为 confirm 的 属性 ， 并 把 它 设 置 为 tue， 如 果 confirm 的 
值 为 tue， 则 把 这 个 图 书 的 信息 加 入 到 购物 车 中 。 首 先 构造 一 个 ShoppingItem 对 象 ， 然 后 
把 这 个 ShoppingItem 对 象 加 入 到 ShoppingCart 对 象 中 ， 并 把 请 求 转发 到 listjsp。 

(5) 在 addjsp 页 面 中 显示 客户 刚刚 选中 的 图 书信 息 ， 客 户 如 果 不 决定 购买 ， 则 可 以 单 
击 “ 先 不 买 这 个 商品 ”链接 ， 会 返回 图 书 列表 页 面 listjsp。 

(6) 在 addjsp 页 面 和 listjsp 页 面 中 都 提供 了 “查看 购物 车 ”链接 ， 单 击 该 链接 ， 可 
以 链接 到 showcart.jsp 页 面 ， 在 这 个 页 面 中 显示 客户 购买 的 所 有 商品 ， 并 计算 所 有 商品 实际 
需要 花费 的 金额 以 及 节省 的 金额 。 
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* @return Returns the bookid. 
public String getBookid(){ 
return bookid; 


* @param bookname The bookname to set. 
这 
// 书 名 的 设置 和 获取 方法 
public void setBookname(String bookname) { 
this.bookname = bookname; 


} 


J 
* @return Returns the bookname. 
2 

public String getBookname() { 

return bookname; 


} 


/cr 
* @param author The author to set. 
/作者 的 设置 和 获取 方法 
public void setAuthor(String author) { 
this.author = author; 


} 


tr 
* @return Returns the author. 
public String getAuthor() { 
return author; 


} 


pa 
* @param publishdate The publishdate to set. 
ys 
// 出 版 日 期 的 设置 和 获取 方法 
public void setPublishdate(Date publishdate) { 
this.publishdate = publishdate; 
} 


je 
* @return Returns the publishdate. 
人 
public Date getPublishdate() { 
return publishdate; 


lg 
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* @param realprice The realprice to set. 
Wy/ 
// 销 售 价 的 设置 和 获取 方法 
public void setRealprice(float realprice){ 
this.realprice = realprice; 


} 


ji 
* @return Returns the realprice. 
je 
public float getRealprice() { 
return realprice; 


} 


/or 
* @param cutprice The cutprice to set. 
wy 

// 会 员 价 的 设置 和 获取 方法 

public void setCutprice(float cutprice) { 
this.cutprice = cutprice; 


} 


/or 
* @return Returns the cutprice. 
by 

public float getCutprice() { 

return cutprice; 


} 


pe* 
* @param amount The amount to set. 
" 
// 本 书 的 库存 量 的 设置 和 获取 方法 
public void setAmount(int amount) { 
this.amount = amount; 


} 


pe 
* @return Returns the amount. 

public int getAmount() { 

return amount; 

bh 

[A 
* @param description The description to set. 
| 
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// 图 书 描述 信息 的 设置 和 获取 方法 
public void setDescription(String description) { 
this.description = description; 


} 


pe* 
* @return Returns the description. 
yy 
public String getDescription() { 
return description; 


} 


J 
* @param hit The hit to set. 
*/ 
// 该 书 点 击 量 的 设置 和 获取 方法 
public void setHit(int hit) { 
this.hit = hit; 
} 


Jp 
* @return Returns the hit. 
9 

public int getHit() { 

return hit; 


} 


ji 
* @param sellDate The sellDate to set. 
Sf 
// 开 始 销售 的 日 期 的 获取 和 设置 方法 
public void setSellDate(Date sellDate) { 
this.sellDate = sellDate; 


} 


/cr 
* @return Returns the sellDate. 
public Date getSellDate() { 
return sellDate; 


} 


J 
* @param press The press to set. 
i 
// 出 版 社 的 设置 和 获取 方法 
public void setPress(String press) { 
this.press = press; 


} 
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iffitems.containsKey(bookid)i{f 
items.remove(bookid); 
ShopBookltem newitem = new ShopBookltem(book,num); 
items.put(bookid,newitem); 

jelsef 
ShopBookltem newitem = new ShopBookltem(book,num); 
items.put(bookid,newitem); 


itemAmount++ ; 
* 从 购物 车 中 移 除 指定 的 图 书 项 目 
中 


public synchronized void remove(String bookidj{ 
if(items.containsKey(bookid))\{ 
items.remove(bookid); 


} 


1 

// 获 取 购 物 车 中 所 有 的 图 书 项 目 

public synchronized Collection getltems(){ 
return items.values(); 

} 

protected void finalize(X{ 
items.clear(); 


} 

// 获 取 当 前 购物 车 中 图 书 项 目的 数目 

public synchronized int getltemAmount(){ 
return itemAmount; 


1 
// 计 算 购物 车 中 所 有 图 书 的 市 场 价值 
public synchronized float getTotalReal(){ 
float total = 0.0F; 
forllterator it = getltems().iterator();it.hasNext();X{ 
ShopBookltem si = (ShopBookltem)it.next(); 
Book book = si.getltem(); 
total = book.getRealprice()*si.getAmount(); 
1 


return total; 


// 计 算 购物 车 中 在 本 站 购物 所 需要 的 所 有 花费 之 和 
public synchronized float getTotalCut(){ 
float total = 0.0F; 
for(lterator it = getltems().iterator();it.hasNext();){ 
ShopBookltem si = (ShopBookltem)it.next(); 
Book book = si.getltem(); 
total = book.getCutprice()*si.getAmount(); 
b 


return total; 


“562 。 JSP 网 络 开发 技术 及 整合 应 用 


} 

// 清 空 购物 车 

public void clear(){ 
items.clear(); 
iemAmount = 0; 


} 


31.2.3 ”购买 项 目 Bean 一 一 ShopBookltem 


购买 项 目 Bean 一 一 ShopBookItem.java 也 是 一 个 很 简单 的 JavaBeans。 它 在 整个 Web 应 
用 中 的 作用 并 不 是 很 明显 ， 它 只 是 用 来 连接 Book 和 BookShopCart 的 一 个 类 ， 它 的 实现 也 
不 是 很 标准 ， 但 它 可 以 完成 封装 Book 的 作用 。 下 面 是 ShopBookItem.java 的 源 代码 : 


package cn.ac.ict.BookStoreOnline; 

import java.io.Serializable; 

public class ShopBookltem implements Serializable { 
private Book item; 
private int amount = 0; 


public ShopBookltem(){ 
super(); 
} 
er 
* 使 用 指定 的 图 书 和 它 的 数目 构造 一 个 购买 项 目 
yy 
public ShopBookltem(Book newbook,int num) { 
super(); 
if(num>0X{ 
item = newbook; 
amount = num; 


} 


| 
public void InAmount(){ 
amount++; 


b 
public void DeAmount(){ 
amount--; 


} 
// 获 取 一 个 图 书 项 目 
public Book getltem(){ 
return item; 


// 获 取 购 物 车 中 图 书 项 目的 数量 
public int getAmount(){ 
return amount; 
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31.4 JSP 页 面 


JSP 页 面 的 主要 作用 就 是 要 提供 给 客户 一 个 良好 的 用 户 界面 , 同时 也 实现 了 一 定 的 逻 


操作 功能 。 


31.4.1 图 书 列表 页 面 


诅 


指 


实现 图 书 列表 的 页 面 是 listjsp 文件 。 在 这 个 文件 中 , 首先 包含 了 用 于 连接 数据 库 的 init. 


jsp 文件 ， 获 得 数据 库 连 接 后 ， 从 中 查询 出 所 有 的 图 书 然后 在 页 面 上 显示 。 下 面 是 这 个 文件 


的 源 代码 : 
<%@ page language="java" pageEncoding="GB2312" %> 


<%@ page import="java.sql.*,cn.ac.ict.BookStoreOnline.*" %> 
<!DOCTYPE HTML PUBLIC "“-//w3c//dtd html 4.0 transitional//en"> 


<html> 
<head> 
<title> 图 书 列表 </title> 
<style type="text/css"> 
< 全 
.bookname { 
font-size: 20px; 
line-height: 30px; 
color: #CC9900; 
yi 
.description { 
font-size: 13px; 
color: #FF0000; 
background-color: #CCCCCC; 
} 
.common { 
font-size: 14px; 
color: #333333; 
-> 
</style> 
</head> 
<body bgcolor="#FFFFFF"> 
<%@ include file="init.jsp"%> 
<% 


Statement stmt = conn.createStatement(); 


ResultSet rs = stmt.executeQuery("select * from books"); 


%> 
<table width="778" border="0" align="center"> 


加 载 中 
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}%> 
</table> 
</body> 
</html> 


在 上 面 的 代码 中 使 用 了 一 个 工具 类 ShopUtil, 它 只 有 一 个 很 简章 
ISO8859-1 编码 的 字符 串 转换 为 使 用 gb2312 编码 的 字符 
在 本 程序 中 使 用 如 下 语句 获取 数据 库 中 的 数据 : 
Statement stmt = conn.createStatement(); 
ResultSet rs = stmt.executeQuery("select * from productlist"); 


然后 就 不 断 地 循环 ， 把 所 有 商品 的 信息 输出 到 页 面 显示 。 这 个 页 面 执行 后 ， 效 果 如 
图 31.2 所 示 。 


的 静态 方法 用 于 把 使 用 
。 本 书 不 作 介 绍 。 


EE I 


| 
ON 


图 31.2 所 有 可 购买 的 图 书 列表 
31.4.2 ”添加 图 书 确认 页 面 


在 添加 图 书 确认 页 面 (add.jsp) 中 可 以 修改 购买 图 书 的 数量 ， 并 确认 把 指定 数量 的 图 书 
加 入 到 购物 车 中 。 同 时 ， 这 个 页 面 中 表单 的 提交 页 面 也 是 add.jsp， 根 据 传 入 的 不 同 参数 进 
行 不 同 的 操作 。 下 面 是 addjsp 的 源 代码 : 

<%@ page language="java" pageEncoding="GB2312" %> 

<%@ page import = "java.sql.*,cn.ac.ict.BookStoreOnline.*"%> 


<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 


<head> 
<title> 购 买 商品 </title> 
<style type="text/css"> 
二 
.top{ 
font-size: 18px; 


.tabletop { 
font-size: 16px; 
color: #3991D0; 
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{ 

/如果 客 户 对 提交 的 信息 取消 了 ， 将 页 面 转发 到 listjsp 
Session.removeAttribute(addpid); 
response.sendRedirect("list.jsp"); 

} 

else{ 

%> 

<form action='add.jsp' method='get> 

<table align=center> 


<thead><center> 

<p class="top"> 修 改 购买 图 书 的 数量 并 把 它们 加 入 到 您 的 购物 车 </p> 
</center></thead> 
<tr> 


<td class="tabletop"> 图 书 名 称 </td> 

<td class="tabletop"> 出 版 社 </td> 

<td class="tabletop"> 作 者 </td> 

<td class="tabletop"> 出 版 日 期 </td> 

<td class="tabletop"> 定 价 </td><td class="tabletop"> 会 员 价 </td><td 
class="tabletop"> 数 量 </td><td class="tabletop"> 小 计 </td></tr> 
<tr> 
<td 
class="tablecontent"><%=BookShopUtil.getChinese(temp.getBookname())%></td> 
<td 
class="tablecontent"><%=BookShopUtil.getChinese(temp.getPress())%></td> 
<td 
class="tablecontent"><%=BookShopUtil.getChinese(temp.getAuthor())%></td> 
<td class="tablecontent"><%=temp.getPublishdate()%></td> 
<td class="tablecontent"><%=temp.getRealprice()%></td> 
<td class="tablecontent"><%=temp.getCutprice()%></td> 
<td class="tablecontent"><input type=text size=2 name="amount" value=<%=count%>></input> 
</td> 
<td class="tablecontent"><%=count*(temp.getRealprice())%></td> 
</tr> 
<input type="hidden" name="confirm" value="true"> 
<input type="hidden" name="add" value="<%=addpid%>"> 


<tr> 


<td style="border:2 solid " colspan=2 align=center><a href="list.jsp" class="linkstyle"> 先 不 买 这 个 
商品 </a></td> 

<td style="border:2 solid ” colspan=3 align=center><a href="showcart.jsp" 
class="linkstyle"> 查 看 购物 车 </a></td> 

<td style="border2 solid " colspan=3 align=center><input type=submit size=2 name="buy" 
value=" 确 定购 买 "></input></td> 

</tr> 

</table> 

</form> 

<%}%> 

</body> 

</html> 
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这 个 页 面 的 显示 效果 如 图 31.3 所 示 。 


而 mlm 


图 31.3 添加 图 书 确认 页 面 


31.4.3 ”中 转 页 面 


在 从 图 书 列表 页 面 到 添加 图 书 确认 页 面 中 间 还 有 一 个 中 转 页 面 ， 它 没有 具体 的 显示 任 
务 ， 它 完成 一 些 处 理 任务 后 ， 把 请 求 转 发 到 其 他 页 面 。 在 本 例 中 的 putintocart.jsp 就 是 这 样 
-个 页 面 。 它 完成 的 功能 
口 获得 客户 要 购买 的 某 种 图 书 的 详细 信息 。 
口 把 图 书 的 详细 信息 封装 成 Product 对 象 。 
口 把 图 书信 息 对 象 保存 到 Session 中 。 
口 把 客户 请 求 转发 到 添加 图 书 确认 页 面 。 
putintocart.jsp 的 源 代码 如 下 : 
<%@ page language="java" pageEncoding="GB2312" %> 
<%@ page import = "java.sql.*,cn.ac.ict.BookStoreOnline.*"%> 
<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 
<head> 
<title>Lomboz JSP</title> 
</head> 

<body bgcolor="#FFFFFF"> 
<%@ include file="init.jsp"%> 
<jsp:useBean id="shopcart" scope="session" 
class="cn.ac.ict.BookStoreOnline.BookShopCart" /> 
<% 

String addpid = request.getParameter("add"); 

if (addpid!=null}X{ 
// 如 果 客 户 要 添加 一 本 图 书 ， 则 从 数据 库 中 得 到 图 书 的 详细 信息 

Statement stmt = conn.createStatement(); 
ResultSet rs = stmt.executeQuery("select * from books where bookid=' "+addpid+" ' "); 
rs.next(); 


Book temp = new Book(); 
temp.setBookid(addpid); 
temp.setBookname(rs.getString("bookname")); 
temp.setAuthor(rs.getString("author )); 


加 载 中 
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<!DOCTYPE HTML PUBLIC "-//w3c//dtd html 4.0 transitional//en"> 
<html> 
<head> 
<title> 查 看 购物 车 </title> 
<style type="text/css"> 
<-- 
‘top{ 
font-size: 18px:; 
1 
.tabletop { 
font-size: 16px; 
color: #3991D0; 
background-color #CCCCCC; 
border: 2px solid #666666; 
b 
.tablecontent { 
font-size: 14px; 
color: #000000; 
border-bottom-width: 1px; 
border-bottom-style: solid; 
border-bottom-color: #666666; 
text-align: center; 
} 
.linkstyle { 
text-decoration: none; 


} 


-> 
</style> 
</head> 
<body bgcolor="#FFFFFF"> 
<%@ include file="init.jsp" %> 
<jsp:useBean id="shopcart" scope="session" 
class="cn.ac.ict.BookStoreOnline.BookShopCart" /> 
<% 
String clear = request.getParameter("clear ); 
/客户 请 求 清空 购物 车 
ifclearl=null&&clear.equalslgnoreCase("true")){ 
shopcart.clear(); 
%> 
<table align=center><tr><td class="top"> 您 的 购物 车 已 经 被 清空 ，<a href = "list.jsp"> 返 回 图 书 
列表 </a></td> 
</tr></table> 
<% 
上; 
if(shopcart.getltemAmount()>0X{ 
// 列 出 购物 车 中 所 有 的 图 书 
%> 
<table align=center border=0> 
<thead align=center><h2 class="top"> 您 在 购物 车 中 加 入 了 如 下 图 书 商品 </h2></thead> 
<tr> 
<td class="tabletop"> 图 书 名 称 </td> 
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<td class="tabletop"> 出 版 社 </td> 

<td class="tabletop"> 作 者 </td> 

<td class="tabletop"> 出 版 日 期 </td> 

<td class="tabletop"> 定 价 </td><td class="tabletop"> 会 员 价 </td><td 
class="tabletop"> 数 量 </td><td class="tabletop"> 小 计 </td><td class="tabletop"> 修 改 </td></tr> 
<% 


Collection coll = shopcart.getltems(); 


lterator ite = coll.iterator(); 

whilelite.hasNext()){ 

ShopBookltem si = (ShopBookltem)ite.next(); 

Book p = si.getltem();%> 

<tr> 

<td 
class="tablecontent"><%=BookShopUtil.getChinese(p.getBookname())%></td> 
<td class="tablecontent"><%=BookShopUtil.getChinese(p.getPress())%></td> 
<td class="tablecontent"><%=BookShopUtil.getChinese(p.getAuthor())%></td> 
<td class="tablecontent"><%=p.getPublishdate()%></td> 

<td class="tablecontent"><%=p.getRealprice()%></td> 

<td class="tablecontent"><%=p.getCutprice()%></td> 

<td class="tablecontent"><%=si.getAmount()%></td> 

<td class="tablecontent"><%=p.getRealprice()*si.getAmount()%></td> 

<td class="tablecontent"><a href='add.jsp?amount=<%=si.getAmount()%>&add=<%=p.getBookid() 
%>' class="linkstyle"> 修 改 数 量 </a></td> 

</tr> 


<%}%> 
<tr align=left><td colspan=9> 本 次 购物 您 <font color=red> 本 来 </font> 需 要 花费 <font color=red><% 
=shopcart.getTotalReal()%></font> 
在 本 站 购买 需要 <font color=red><%=shopcart.getTotalCut()%></font></td></tr> 
<tr align=left><td colspan=9> 在 本 站 购物 为 您 <font color=red> 节 省 了 <%=(shopcart.getTotalReal() 
-shopcart.getTotalCut())%></font></td></tr> 
<tr align=center><td colspan=4 style="border:2 solid "><a href="listjsp" class="linkstyle"> 继 续 购买 
</a></td> 
<td colspan=5 style="border:2 solid "><a href="showcartjsp?clear=true" class="linkstyle"> 清 空 购 
物 车 </a></td> 
</tr> 
</table> 
<% 
}else{ 
if(clear==nullll(!clear.equalslgnoreCase("true"))){ 
%> 
<table align=center><tr><td> 您 的 购物 车 中 暂时 没有 任何 商品 ， 
<a href = "list.jsp"> 返 回 产品 列表 </a></td></tr></table> 
<% 


} 

%> 
</body> 
</html> 
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您 购买 的 书 名 : 您 的 姓名 : 性 别 : 口 男 长 
年 龄 文化 程度 : 职 业 : 
了 编 : 通信 地 址 : E-mail: 
您 常用 的 软件 : 1 bs 9 4 


您 购买 本 书 的 原因 (可 多 选 ): 
封面 与 装帧 口 引言 目录 口 正文 内 容 口 丛书 风格 口 价格 ” 口 光盘 口 专业 性 强 口 别人 介绍 
出 版 社 或 作者 名 声 售后 服务 


本 书 最 令 您 满意 的 是 (可 多 选 ): 


专业 性 强 、 覆 盖 面 广 内 容 翔 实 、 定 位 准确 精益 求 精 、 售 后 服务 
您 可 以 承受 的 图 书 价格 : 
20 元 以 下 30 元 以 下 40 元 以 下 口 50 元 以 下 口 只 要 内 容 好 ， 不 论 价格 
您 对 本 书 的 评价 : 
时 面 装帧 : 口 很 好 较 好 口 一 般 口 不 满意 建议 
印刷 质量 : 口 很 好 较 好 口 一 般 口 不 满意 建议 
正文 质量 : 口 很 好 较 好 - 般 口 不 满意 建议 
写作 风格 : 口 很 好 较 好 - 般 口 不 满意 建议 
专业 水 平 : 口 很 好 较 好 - 般 口 不 满意 建议 
您 希望 增加 哪些 图 书 选 题 : 1 2 3 
您 认为 本 书 有 哪些 错误 : 
章节 页 码 行 列 图 号 错误 应 改 为 
章节 页 码 行 列 图 号 错误 应 改 为 
前 节 页 码 行 列 图 号 错误 应 改 为 
前 节 页 码 行 列 图 号 错误 应 改 为 
您 的 其 他 建议 
1 
2 
3 
请 填 好 本 卡 后 寄 给 : 
清华 大 学 校内 金地 公司 邮编 : 100084 电话 : (010) 62791976-220 
《JSP 网 络 开发 技术 及 整合 应 用 》 编 辑 部 收 
传真 : (010) 62788903 公司 网 址 : www:thjd.com.cn E-mail: oyzx_sp@263.net 


如 需 本 书 可 与 本 编辑 部 联系 邮购 ， 汇 款 请 按 以 上 地 址 填写 ， 另 加 邮费 15% (挂号 ) 


